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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


1.0 MAJOR CHARACIERISTLCS_OE_IMIS_BUILD 


0 Cycle 6 and subsequent cycles of NOS/VE are built to run with 
a NOS 6.1 base system and the DSD displays and commands have 
changed considerably from the NOS 5.23 base system used with 
Cycie 5. This hints document has been updated to reflect 
these changes where they affect NOS/VEs for Instances using 
the command NVEnnann to bring up NOS/VE instead of cp.NVEnnnn. 
For more information on the AGS commands see 3J Swierzbin'ts 
memo of July 23 titted 'NOS 6.1 Notests the NOS reference 
manuals Jisted in Apoendix Ay or the NOS R& Software Release 
Bulletin. . 


9 To access NOS/VE interactivelys the user must login to the 
apolication named YEITIAF. For example: sDAH»sDPAHX»sVETAF The 
previous application name was TAF. 


o With Cycte 7» the operator of the NOS/VE dual state system can 
simulate terminal breaks. She/he may issue at any time a 
*BREAK at the K display for the NYE Joh. This will start the 
terminal breaks, which works Just tike the interactive break. 
The broken command may be continued by issuing the 
resume _command (resc) or may be terminated hy issuing the 
terminate command (tere). If the command get _file is obroken 
intos, the command will be terminated by the Remote Host. 
After the DS proc has been executeds 2 terminal break at the 
command tevel will cause the SCL task to terminate. The job 
monitor task wild restart the SCL task after a brief detay (up 
to 20 secands). 


o Miscellaneous SCL Changes: 


A RING parameter has been added to the TASK/TASKEND 
command. This parameter may be used to switch to a new ring 
of execution within the user's validated minimum ring and 
nominal lringe 


A $RING function has heen added. It has no arguments and 
returns the current ring of execution. 


Commands from user jobs are no longer written to the system 
log by default. This function is controlled by the new 
operator commands ACTIVATE_SYSTEM_LOGGING and 
DEACTIVATE_SYSTEM_LOGGING. 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


The abbreviation for the SKIP_L TAPE command has been 
corrected te SKIT from SKIPT. 


A new internal interfaces CLPSVALIDATE_NAME has been 
added. This is an INLINE procedure that should be used 
Instead of the high overhead CLPSCONVERT_LSTRING_TO_LNAME. (See 
common deck CLXYN for interface details.) 


o DISPLAY FILE leaves the source file with an attribute of 
RT=U,. This can be corrected by setting the RT attribute back 
to the correct vaiue after the DISPLAY vaiue: SETFA file RT=V 


o COPYLFILE will not copy at ECI if it had been specified on the 
COPF command. The following sequence will accomplish copying 
at EQT: 


SETFA dest_file OP=SE0T 
COPF source _file dest_file 
SETFA dest_file OP=%80T 


9 The permanent file system has been modified to make Files 
Invisible when al! cycles have been purged even if one or more 
of those cycles are still attached. This results in 
references to the file emitting an unknown file message as 
expecteds rather than an unknown cycle message containing an 
invaiid cycté number. It also prevents display cataiog 
commands from showing the file as having zero cycles. 


9 The administer utillty has been updated to correspond to Reve 
9 of the NOS/VE Command Interface ERS. Did command and 
parameter names are no longer supported. 


9 The TAFNVE operator command (TAF centroli point) is no tonger 
required or available. The capabilities that were provided by 
jt have been packaged within the NVE sunsystem controi pointe 
The impact of this change is as follows: 


- The K display is assigned to the same control poltnt 
during both deadstart and normal system operations 


- fQflutput from the system core debugger will no tonger 
appear at the NVE control point K-display. Al} system 
core debugger communication is via the MOD terminal. 


~ The Ke*BYEVE. command is no tonger available. 


- The GFFSWs jsns6. command before doing a STOPs jsn. is 
not required to bring NVE down, 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


~ Al capabilities are available via the NVEXXXX. 
command. The NYE subsystem may be piaced at any control 
point (like NAM is). 


o Cycle & (actually Cycie 4) of NOS/VE no longer supports the 
"old”™ command names for system commands. Both “oid” and "new" 
names have been supported since Build Q. See DAP ARH4776~ for 
details. As part of this change the abbreviations for the 
COPY_LFILE and PRINT_LFILE commands have been corrected to COPF 
and PRIF (from COPYF and PRINTF). 


0 The EXPLAIN command was implemented in Cyctie 4 of NOS/VE. 
Dontit get too excited about thiss howevers, because as yet 
there are no "explain tevel™ message templates for any of the 
system conditions. EXPLAIN will simply regqurgitate the 
regular messaqe. 


While implementing the EXPLAIN command it was discovered that 


the specification of the command (i.@. that It have an 
optional “condition” parameter) was not nearly as useful as 
having the first parameter be a "status" value. So the 


implementation deviates from the ERS in that the first 
parameter to EXPLAIN is MESSAGE_LSTATUS or MS and is of kind 
STATUS. The SSTATUS function can be used to transform a 
"condition™ into a ™"status™. A DAP is beina written to make 
this change official. 


o NOS/VE multiple mass storage volumes have been implemented In 
Cycia 5. For nore information see the section Configuration 
Management!. 


9 The implicit attach process has been modified to choose share 
mode to be the following function of eccess mode. If access 
mode inctudes shortens append or modify then share mode is 
nones otherwise share mode is read and execute. This resuits 
in alilowing sharing of Implicitly attached files that are not 
being written but inhibiting sharing of implicitly attached 
Files that are being written. 


The implicit attach oerocess formerly chose share mode to be 
the share raquirements established by the permit mechanism. 
The owner of files typically has no share requirements and 
hence would iImplicitty attach the files for exclusive accesses 
This created a savere usability problem for code or command 
files that were to he executed by multiple Jobs. 


o An ENI problem exists with respect to a file shared between 
Jobs. An existing file is opened with an access mode of 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


append by job A. The same file is opened with an access mode 
of read by job 3. Job A extends the file and either 
explicitly closes the file or terminates. Job B explicitly 
closes the file or terminates. In this case» since the job 
accessing the file in read mode terminated after the job which 
extended the files EOI on the file will be reset to the 
original position and the result of the extend will be tost. 


o The Interstate Communication Facillitys which is described in 
Section 9 of the NOS/VE ERS - Program Interface {Reve 8)» has 
heen implemented. The cailabie subroutines described in 
section 923 reside in User Library LINKLI8 in the Integration 
catalogs INTl» DEV1i» RELI» etc. NOS tibraries SYSLIB- and 
SRVLIB are also required te complete the loading process.e 
LOSET joader commands must be used to select these tJibraries. 


o Interactive Usage Restrictions? 


- When Jogging In to NOS/VE (i.e. HELLOsVEIAF etc.) do not 
enter a terminate break (CTRL t) or a pause break (CTRL p) 
before the ‘welcome message! appears at the terminal. A 
pause or terminate break entered before the Interactive 
NOS/VE job has completed it's Initialization may crash the 
System. 


- A REQUESTLTERMINAL command in a batch job will crash the 
system, This oan happen accidently through a 
REQUESTLUTERMINAL command in a user prelog when the user 
runs a batch job since the oprolog is executed for both 
interactive and batch Jobs. The problem can be avoided by 
making the REQUEST TERMINAL command in the prolog 
conditional on the job tyre as foilows:; 


IF $JO8(MODE) <> 'BATCH® THEN 
REQUEST _TERMINAL 
IFEND 


o Any product or utility that is placed in the S3SYSTEM catalog 
{or any freguently toaded program) should be bound using the 
CREATE_LMODULE subcommand of the CREATE_OBJECT_LIBRARY 
utility. This will minimize overhead associated with tloading 
the product or utility. 


o Debug responds to terminal breaks when a program is being 
debuggede How2vers entering a pause or terminate break when 
debug is active (i.e. the DB/ prompt has appeared and the 
user has not issued the RUM command) wil! cause the task to 
terminate. 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 


When sharing executable files via permanent files (i.@. 
compilers» Jibrariess  etce) you should make the file an 


ebject Iibrary via the CREATE_LNBJECTLLIBRARY utility. By 
sharing object tibraries Instead of object files» the code jis 
actually shared among all tasks using the library; the library 
is not copied to another segment but is executed directly. 


1.1 NOS/VEUSAGE EXAMPLES 


Lelel EXECUTING PROGRAMS 


PROCESS 


Create an object text file by comelling a program on NOS. 


Then perform the following steps on NGS/VE:? 


Acquire any necessary libraries (which are not quoted in text 
embedded directives) by aither: 


o Attaching them from the system catalogs either explicitly 
or via prolog 
or 
o Creating the fibdrary file via the object ftibrary generator 
or 
o Staging the library File from NOS to NOS/VE using the 
GET_OBJECTLLIRRARY command. 


Get the file from NOS and convert the object text file from 
the CI data mapping to II data mapping by executing the 
CONVERT LOBJECTLFILE command. 


Load and execute the program via the EXECUTE_TASK commands 
specifying the necessary jibraries with the LIBRARY parameter; 
alternatively SET LPROGRAM_ATTRIBUTES may be used to inctude 
the tibraries in atl subsequent EXECUTE_TASK commands. 


Stage the floadmap from NOS/VE to NOS for printing by using 
either: 


o The REPLACE_FILE command with A6 conversion mode specified 
if running on the simulator. 
or 
o The PRINTLFILE command if running on the hardware. 
EXAMPLES 
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Lelel EXECUTING PROGRAMS 


The following is an exampie command sequence for executing a 
program not requiring any libraries for loading: 


Assumptions: all modules to be floaded are contained on the NOS 
permanent file 'citxtrs?. 


CONVERTLOBJECTLFILE CITXTRS 
EXECUTELTASK CITXTRE PARAMETER='program parameters? 
PRINTUFILE LOADMAP 


The following is an example command sequence for executing a 
program requirine libraries for loading: 


Assumptions: the NOS permanent file 'citxtrs' contains object 
text generated by the CYBIL CI compiler. The compiler modules 
reference procedures contained on the tTibrary j'‘mylib' and the 
CYBIL run-time library. These libraries have been generated on 
NOS/VE and saved on NOS. 


GETLOBSJECT_LLIBRARY MYLIB 

SETLPROGRAM_ATTRIBUTES LOAD _MAP_DPTIONS=(BLOCKsENTRY_ POINTsSEGMENT 
CONVERTLOBJECT_FILE CITXTRS 

EXECUTE_LTASK CITXTRS %program parameters? LIBRARY=MYLI3 

PRINTLU FILE LOADMA® 


Le1.2 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 


Notes: 


o CLG8170 is NOS permanent file name for file containing CI 
object text for moduies to be included in the library. 


o JITEXT180 is NOS/VE jocal file name for file containing I1 
object text for modules to be included in the tibrary. 


o LIBRARY180O is NOS/VE tocal file name for the tibrary being 
created. 


re) ILIB170 is NOS permanent file name for file containing the 
fibrarye 


NOS/VE Job Commands 
CONVERTLGBJECTL_LFILE TITEXT1I80 CLGD1790 
CREATE_OBJECT_LLIBRARY 
ADD MODULE LIBRARY=TITEXT1390 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 
1.1.22 CREATE OBJECT LIBRARY ON NOS/VE AND SAVE IT ON NOS 


GENERATE_LIBRARY LIBRARY=LIBRARY1806 
QUIT 
REPLACELFILE LIBRARY180 ILIB170 DC=B56 


Lel.3 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 


Notes: 


o ILIB170 is NOS permanent file name For file containing the old 
library 


o LIBRARY180 is NOS/VE tJocal File name for file containina the 
oid library 


o CMO0D170 is NOS permanent file name for file containing CI 
object text for the new module 


o NEWIIMQOULE Is NGS/VE tTocal fille name for file containing II 
object text for the new module 


o NEWLIBRARY is NOS/VE local file name for the tibrary being 
created 


o NLIBI70 is NOS Jecai file name fer new library 
NOS/VE Job Commands 


GET_LOBJECTLLIBRARY LIBRARYI8BG ILIB170 
CONVERTLOBJECTLFILE NEWTIMDOULE CMO0170 
CREATE_OBJECT_LIBRARY 

ADD_MODULE LIBRARY=LIBRARY180 
REPLACE_MODULE LIBRARY=NEWTIMODULE 
GENERATE LIBRARY LIBRARY=NEWLIBRARY 
QUIT 

REPLACE_LFILE NEWLIBRARY NLIB170 DC=B56 


Lo1e4 ROUTE AN INPUT FILE FROM NOS TO NOS/VE 


Running from an Interactive terminals enter: 


GETsfilename. 
RQNUTEsFfilenamesDC=LP.FC=RH. 


The input file which is sent to NOS/VE must be In 6/12 ASCII 
(or display code subset). The job File must be ae single 
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12.0 MAJOR CHARACTERISTICS OF THIS BUILD 
Lele ROUTE AN INPUT FILE FROM NOS TO NOS/VE 


partition NOS record containing NOS/VE commands. The first 
statement must be a valid LOGIN command with users password and 
family name specified. Multi partition input files are not 
supported by NOS/VE so NOS data files used by the program must be 
obtained through the GET_LFILE command. 


1.1.25 PRINT A NOS/VE FILE 


At NOS/VE job termination the job fog will be automatically 
returned to NOS. The job log will be appended to the NOS/VE 
output file OUTPUT. NOS/VE print files must ba written by BAM as 
8/8 ASCII RT=V. Print files will be converted from 8/78 ASCII 
RT=V to NOS 8/12 ASCII when they are sent to NOS and will be 
printed in upper/lower case. 


All NOS/VE output files wil! appear in the NOS output aqueue 
{NOS H»s0 display) with the name IRHFxxx as a banner. In order to 
print a NOS/VE files the following command must be issued within 
your job or be entered from the system console via the operator 
facility: 


PRINTLFILE filename 
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200 COMMAND INTERFACE STATUS 


2+0 COMMAND INTERFACE STATUS 


2@el ACCESS_IO_NOSZVE_IN_OUAL STATE. 


2elel 


To 


First 


LOGIN TO NOQS/VE 


initially ftegin to NOS/VE via VEIAFs you must cause the 
login attempt to fail. This can be done by responding to 


the "FAMILY:" login prompt with something !fike: "»59". This must 
be done because the system will try to connect the terminal to 


TAF 


on the first login attempt no matter what is typed. To 


access VEIAF do the following on the second "FAMILY:™" prompt: 


suserspasswordsVETAF 


You can access VEIAF from TAF by doing "HELLO»sVEIAF™ or by 
answering VEIAF to the system prompt "APPLICATION:?*%. 


ZeleZ2d 


1) 


2) 


3) 


TERMINAL USAGE 


Thea siant (7) Is the prompt to enter a NOS/VE command. Any 
normal NOS/VE command can now be entered (continuation 
fines are prompted with .e/). The full ASCII character 
sets lower or upper casa and alli special characterss can be 
used. 


A LOGOUT command will cause the NOS/VE Interactive Job to 
terminate. A new NDS/VE Interactive Job can then be 
started by responding to the 'PtAPPLICATION:! prompt with 
VETAF. 


Terminal breaks (controi-t and control-p) can be used to 
terminate atask or command and suspend a task and enter a 
new task to process SCL commands. Control-t causes a 


terminate break and control-p causes a pause breaks 
Terminate break will terminate 6a command or the most 
recently executed task. A pause break will suspend 
execution and allow commands to be entered. When a 
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Zele2 TERMINAL USAGE 


terminal is in poause break states two additional commands 
are availabie: 


RESUME COMMAND -—- resume execution at the point. of 
interruptions 


TERMINATE_COMMAND - cause a terminate break condition as 
a terminate break had been entered. 


Both terminate break and pause break are avallable to programs 
as conditions via the program management condition mechanism. 


2eile3 NOS/VE PROGRAM ACCESS TH THE TERMINAL 


1) Interactive NOS/VE jobs are abie to obtain terminal input 
through the AMPSGET_NE XT or AMPSGET_ PARTIAL oprogram 
interface which can be used by both task services and user 
ring programs. Interactive programs which use this 
Interface should be able to handie beth upper and tower 
case input in order to make them more convenient to use in 
both 64 and 96 character set modes. 


2e2 COMMAND AND PARAMETER NAMES 


During the next few months a command supported by the system 
may not be in syne with your command interface document. The 
parameter descriptor table gives an accurates concise description 
of the command interface as currently supported. 


POI_Reader's Guide 

The definition of a command's parameter fist is enclosed in 
parenthesis with $a parameter description per tine. Each 
description has the general forms 
PARAMETER NAME: ALLOWED PARAMETER VALUES = PARAMETER DEFAULT 
YALUE 


Parameter Names —- describes the parameter name and any 
abbreviations. 


ALLOWED PARAMETER VALUES - describes the kind of value allowed 
and whether a list of vaiues is possibie. The value kind can be 
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further qualified. In some cases, the actual vaiues allowed are 
described using the KEY notation. The vatue kinds inciude 
INTEGERs STRING» NAME» FILE» STATUS. 


PARAMETER DEFAULT VALUES - descrihes the defautting rules 
and/or values for the sarameter. $REQUIRED and SOPTIONAL are 
obvious. Other values in this position will be treated as iif 
they were entered by tha user on command invocation, 


See the PROC command In the Command Interface EPS for more 
details. 


The POTs for the commands currently in the system can be 


displayed using the DISPLAY_COMMAND_INFORMATION command. This is 
documented in the nonstandard command section of this document. 


2.3 COMMAND _EUNCTIONS 


Eunction Status 

M00 unchanged 
$CHAR unchanged 
$CLOCK unchanged 
$DATE unchanged 
SF Ice unchanged 
SFNAME unchanged 
$INTEGER unchanged 
SNAME unchanged 
$ORD unchanged 
SBREAL unchanged 
SSTRING unchanged 
$STRLEN unchanged 
SSTRREP unchanged 
$SUBSTR unchanged 
SUNIQUE unchanged 
S$TIME unchanged 
SVAR unchanged 
S$SPECIFIED unchanged 
S$SETU COUNT unchanged 
SVALUE_COUNT unchanged 
SRANGE unchanged 
SPARAMETER_LIST unchanged 
SPARAMETER unchanged 
$STATUS unchanged 
S$CONDITION unchanged 
SSEVERITY . unchanged 
SPROCESSOR unchanged 
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1 


$JO8 
SP ROGRAM 


LYSTEM_ ACCESS COMMANDS 


Commands 


SETLLINK_LATTRIBUTES 
LOGIN 

LOGOUT 

SETLPASSWORD 


The family name of the job doing the submit will 
the default family name on batch jobs. 


unchanged 
unchanged 


altatus 


unchanged 


unchanged - ¥*1 


unchanged 
unchanged 


submitted from NOS will be family SSYSTEM. 
means that whenever NOS/VE jobs are submitted from NOS the 


family parameter is required. 


RESQURCE MANAGEMENT 


Command 


REQUESTLTERMINAL 
EILE_NANAGENENT 


Command 


SETLFILE_LATTRIBUTES 
COPY_LFILE 

DISPLAY_FILE 
COMPARE_FILE 
DISPLAY_FILE_LATTRIBUTES 
SKIPLTAPE 


PERMANENT_EITLE_ MANAGEMENT 
Command 
GET_LFILE 


REPLACE_FILE 
CREATE_FILE 
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aiatus 


unchanged 


otatus 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


atatus 


unchanged 
unchanged 
unchanged 
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used as 


The default for jobs 
effectively 
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ATTACHLFILE 
DELETE_LFILE 
CHANGE_CATALOG_LENTRY 
CREATELFILE_PERMIT 
DELETE_LFILE_PERMIT 
CREATE_CATALOG 
DELETE_LCATALOG 
DELETE_LCATALOG_PERMIT 
CREATELPERMIT_CATALOG 
DISPLAY_CATALOG 
DISPLAY_CATALOG_ENTRY 
SETLWORKING_CATALOG 


aCL_STALTEMENTS_AND_ PROCEDURES 


Command 


PROC /PROCEND 
SETL_COMMAND_LIST 
DISPLAY_COMMAND_LLIST 
REPEAT/UNTIL 
WHILE/WHILEND 

CREATE VARIABLE 
DELETE_LVARIABLE 
BLOCK /BLOCKEND 
LOOP/LOOPEND 
FOR/FOREND 


WHEN/ WHENEND 

CONTINUE 

CANCEL 

INCLUDE_FILE 
COLLECT_LTEXT 

DISPLAY VALUE 
EXIT_PROC 

ACCEPTL_LLINE 
INCLUDE_LINE 
CREATELFILE CONNECTION 
DELETE_LFILE_CONNECTION 
DISPLAY_LFILE_ CONNEC TION 
change HCS variabie 
display HCS variahlie 
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unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


Siatus 


unchanged 
unchanged 
unchanged 
unchanged 


unchanged | 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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2.9 INTERACTIVE COMMANDS 


*] 


Command 


RESUME COMMAND 

TERMINATE COMMAND 
SET_TERMINAL_LATTRIBUTES 
DISPLAY_TERMINAL_ATTRIBUTES 
esc-e 

esc-] 

esc~ j 

escn~t 

escon-x 


These commands are 


the following meanings? 


xR er. 


2010 QBUECT CODE MAINTENANCE 


Command 


CREATE_LOBSJECT_LLIBRARY 
DISPLAY_NEW_LIBRARY 
SELECT_LDISPLAY_DPTION 
ADDLMODULE 

REPLACE MOOULE 
COMBINE_MODULE 

CREATE MODULE 

BIND MODULE 
CREATE_PROGRAM_DESCRIPTION 
DELETE_MODULE 
CHANGE_LMODULE_ATTRIBUTE 
SATISFYLEXTERNAL_LREFERENCES 
REORDER_MODULE 
GENERATE_LIBRARY 
DISPLAY_OBJECT_LIBRARY 
COMPARE _ODBJECTLLIBRARY 
QUIT 

CI to II Conversion 


entered 


perform "disolay job ustatus”™ 
perform “display_lea 10" command 
perform “"disolay_Jjob_status al!™® command 
discard ail unprocesseds 
terminate jobs but de not disconnect 
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atiatus 


unchanged 
unchanged 
unchanged 
unchanged 
new — 1* 
new - 1* 
new - 1* 
new —- 1* 
new ~- 1* 


with the 
escape keys characters carriage return. 


command 


typed-ahead 


aiatus 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


3—key 


The characters 


input 


sequence? 
have 
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2ell USER SERVICES 


Command status 
DISPLAY_ULOG unchanged 
DISPLAY_MESSAGE unchanged 


2e12 FILE_ ROUTING 


Command atatus 


HOS JMROUTE removed 


2013 2ROGRAM_ EXECUTION 


sh 


Command aftatus 
SETLPROGRAM_ATTRIBUTES unchanged 
DISPLAY_PROGRAM unchanged 
EXECUTE unchanged 
“name call” unchanged ~- ¥1 
TASK/TASKEND . unchanged 
TERMINATE_TASK unchanged 

WAIT unchanged 
SETLDEBLUG_RING unchanged 
DISPLAY_ACTIVE_TASKS unchanged 


Warning - "name cali" works onty for SCL procedures unless a 
SETFA command has been issued to specify that the 
FILE_CONTENTS are OBJECT and the FILE_LORGANIZATION is DATA or 
LIBRARY. The SETFA command must be reissued every time the 
file is brought over from NOS. The CONVERT_LOBJECT_FILE>» 
GETLOBJECT_LFILE»s and GET_OBJECT_LIBRARY nonstandard commands 
issue the appropriate SETLFILELATTRIBUTES command and are 
therefore recommended. 


2014 jOB_ MANAGEMENT 


Commaod afatus 

SUBMIT_J0B unchanged 
DISPLAY _JOBLSTATUS unchanged 
TERMINATE_JOB unchanged 
PRINT LFILE unchanged 
TERMINATE_ PRINT unchanged 
DISPLAY _PRINT_STATUS unchanged 
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2015 NON_ STANDARD _ COMMANDS 


The following commands provide a nonstandard means of 
performing various frequently performed functions. They may be 
superceded in subsequent bulids by standard commands and 
capabilities. 


2015.1 DELETELCATALSG_LCONTENTS § DELCC 


The purpose of this command is to delete all entries from the 
specified catalog. This includes subcatalogs and the files they 
centaine . 


delete catalog _contents [catalog=<catalog>] 
(status=<status variabie>] 


ecatalogic: This parameter specifies from which catalog all 
filles are to be deijietad,. Qmission will cause 
the current working catalog to be used. 


status? See ERROR HANDLING. 
2elSe2 DISPLAY_ACTIVE_TASK ¢{ DISAT 


The purpose of this command is to display task statistics for 
all currently active tasks In a Jobe. The Following information 
is displayed. 


task name 
execution time use 
numoer of page faults 


display active task fCoutput=<file>] 
Cstatus=<status variable>] 


outoutiot This parameter specifles the file to which the 
will 


task statistics is displayed. Omission 
cause ZOUTPUT to be used. 
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2e15e3 DISPLAY_LSYSTEM_DATA i BISSD. 


The purpose of this command is to display system page fault 
statistics and system monitor request statistics. 


display _system_data (display_option=page_faultsiof 
imonitor _requestsimriall 
[display _format=incrementaitiitotality 
foutput=<file>] 
{status=<status variable>] 


display_optionido: This parameter specifies which 
statistics are to be displayed. The 
following cptions are allowed : 


page_faults ~ display the page 
fauit statistics. 


monitor _reauests - display the system 
monitor request 
statistics. 


Qmissicn will cause ALL to be 
used. 
display _formatidf: This parameter specifies whether a 


display of the all statistics recorded 
so far (total) or onty those statistics 


recorded since the last 
display system _data command 
{incremental) should be displayed. 
Qmission will cause incremental to be 
usede 

outputio:s This parameter specifies the file to 
which the system data will be 


displayed. Omission wilt cause $OUTPUT 
to be used. 
status? See ERROR HANDLING. 


201524 DISPLAY_JOBLDATA + DISJO 


The purpose of this command is to display the following job 
related statistics: 
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2015 0% DISPLAY_JOB_DATA ¢ DISID 


time in job mode 

time in monitor mode 

count of page in operations 
reclaimed pages 

new pages assigned 

working set size 

count of ready tasks 


display job _data [display_option=job_datal] 
(display format=incrementaliittotalit] 
Cfoutput=<file>] 
Cstatus=<status variable>] 


dispilay_optionj$do: This parameter specifies which 
statistics are to be displayed. The 
following options are allowed? 


job data —- display job related data. 


Omission will cause job data to be 
used. 
display_formatidf: This parameter specifies whether a 


dispiay of the all statistics recorded 
s0 far (total) or only those statistics 
recorded since the iast display _jcb data 
command (incremental) should be 
displayed. Omission will cause 
incremental to be used. 


outoutio? This parameter specifies the file to 
which the job data will be displayed. 
Qmission will cause S3OUTPUT to be used. 


status: See ERROR HANDLING. 


2015.5 DISPLAY_COMMAND_INFORMATION $ DISCI 


The purpose of this command is to display current information 
about a NOS/VE command. The parameter names» abbreviations» 
allowed values and known problems for a commands as supported in 
the current systems can be determined. This is a nonstandard 
command and will be replaced by the help utility sometime in the 
futuree 


display _command_Information command _name=<nameriall 
Cutility_name=create_object_library: 
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colisource_code_utilityiscuisystem] 


Cdisplay_option=parameter_description_table: 


pdtinetesinamesihelp] 


Coutput=<file referenced] 
C[status=<status variabie>] 


command nameiscn: 


utility vnameiun: 


display _optionido: 


eutputio: 


status: 


This parameter soecifies the name of the 
command about which information is to be 
displayed. 


This parameter specifies which utility the 
command befongs to. QGmission will cause 
SYSTEM to be used. 


This parameter specifies the type of 
display being requested. The options are: 


parameter_cescription_tableipdt - selects 
a display of the parameter descrip~- 
tion table used by the command when 
executed. 


notes —- selects a display of any known 
problems with the cammand. 


Mmames - selects a display of the command 
names for a utilitye 


heip - selects a display of the command 
interface description of the command. 


Omission wild cause PDT to be used, 
This parameter specifies the file to which 
information will be displayed. Omission 
will cause SGUTPUT to be used. 


See ERROR HANDLING. 


201566 CONVERT_LOBJECTLFILE ¢ CONOF 


The purpose of 


this command is to get a NOS/VE object file 


produced on NOS and to convert it to an object file suitable for 


processing by the 
commands. 


NOS/VE loader or object code maintenance 


convertLobject_fiie to=<file reference> 
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{from=<name>] 
Cuser=<name>]j 
{status=<status variabie>] 


toit: This parameter specifies the NOS/VE file name on 
which the converted object file is to be written. 


fromif: This parameter specifies the name of the NGS file to 
be converted. This is the permanent File name as 
defined in the NOS file system and can be up to seven 
characters in length. 


Qmission will cause the permanent file name of the 
T9 parameter to he used. 


user;u: This parameter specifies the NOS user identification 
of the owner of the file. This parameter is only 
neccessary if the file is in a catatog other than the 
user who was specified by the most recently issued 
SETLLINK_ATTRIBUTES command. 


status: See ERROR HANDLIAG. 
2015.7 GETLOBJECTLFILE § GETQOF 


The purpose of this command is to get a previously converted 
NOS/VE object file from the NOS side and sets the appropriate 
file attributes that will allow the object file to be used by 
NOS/VE. 


get lob ject _file to=<file reference> 
{[from=<name>] 
Cuser=<name>d] 
[status=<status variablie>] 


toit: This parameter specifies the NOS/VE file name of the 
object flie. 


from:f: This parameter specifles the NOS file name of the 
object file. This is the permanent file name as 
defined in NOS and can be up to seven characters in 
length. 


Omission will cause the permanent File name of the 
TO parameter to be used. 


useriu: This oarameter specifies the NOS user identification 
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201547 GETLOBJECT_FILE } GETOF 


of the owner of the file, This parameter is onty 
necessary if the file is in a cataleg other than the 
user who was specified by the most recentiy issued 
SETLLINK_LATTRIBUTES command. 


status: See ERROR HANDLING. 
221568 GET_LNBJECT_LIBRARY } GETOL 


The purpose of this command is to get a previously created 
NOS/VE object library From the NOS side and set the appropriate 
file attributes that will allow the object library to be used aon 
NOS/VE. 


getlobject_library to=<file reference> 
Cfrom=<name>] 
Cuser=<name>] 
[status=<Cstatus variablea>] 


tojt: This parameter specifies the NOS/VE file name of the 
object library. 


from3f: This parameter specifies the NOS file name of the 


object file. This Is the permanent file name as 
defined in NOS and can be up to seven characters in 
length. 


Omission will cause the permanent file name of the 
TO parameter to be used. 


useriu: This parameter specifies the NOS user identification 
of the owner of the file. This parameter is only 
necessary if the file is in a catalog other than the 
user who was specified on the most recentiy issued 
SETLLINK_ATTRIBUTES command. 


Status: See ERROR HANDLING. 


2el5e9 OISPLAY_OBJECTLTEXT ¢ DISOT 


The purpose of this command is to produce a formatted display 
of the object text contained In an object file or object tlitrary 
produced on NOS/VE. 
display _object_text file=<file>d 
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foutput=<file referenced] 
Cstatus=<status variabie>] 


fileif: This parameter specifies the object file or object 
library containing the object text to be listed. 


outputio: This parameter specifies the file to which the 
display is to be written. 


Omission will cause the file $OUTPUT to be used. 


status: See ERROR HANDLING, 


2015.19 GETLSOURCE_LIBRARY ¢ GETSL 


The purpose of this command is to get a previcusly created SCU 
source library from the NOS side and set the appropriate file 
attributes that will allow the source library to te used on 
NOS/VE. 


get source _Jibrary to=<file reference> 
{Cfrom=<name>] 
[Tuser=<Cname>] 
Cstatus=<status variable>] 


tost: This parameter specifies the NOS/VE file name of the 
source library. 


fromif: This parameter specifies the NOS file name of the 


source library. This is the permanent file name as 
defined in NOS and can be up to seven characters in 
Jength. , 


Omission will cause the oermanent file name of the 
TO parameter to be used. 


useriu: This parameter specifies the NOS user identification 
of the owner of the file. This parameter is only 
necessary If the file is in a cataitog other than the 
user who was specified on the most recently issued 
SET_LLINK_LATTRIBUTES command. 


status: ‘See ERROR HANDLING. 
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2215-11 EDIT_LFILE } EDIF 
The purpose of EDITLFILE is to initiate the execution of the 
SCU editor on a text File. (For details see ARH3883.) 


edit.file +: edif - edit lines on a source file. (procedure file 
mot necessarily in its final form) 


parameters defaults 
fije=file(source) SREQUIRED 
Cresult=file{source)] SVALUECFILE) 
LTinput=file reference ] *COMMAND 
foutput=file reference] SOQUTPUT 
[status] sce 


2e15.12 JEDIT 


The purpose of this command is to initiate execution of the 
JEDIT editor built by Jack Bohnheff. Anyone wanting information 
about the editor should contact Jack. 


jJedit from=<file> 
Cstatus=<status variabie>] 


fromif: This oarameter specifias the File to be editted. 
This file is rewritten after the editor 
terminates. 


status: See ERROR HANDLING in the NOS/VE Command 
Interface. 


2215.13 DEBUG 


The prototype R1 NOS/VE debugger Is now available. Details on 
how to use the debugger can be found in the “CYBER 180 
INTERACTIVE DEBUG External Reference Specification and User's 
Guide™,» Sunnyvale DCS number $4628. 
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215.14 SETLLINK_LATTRISUTES : SETLA 


The SETLLINK_ATTRIBUTES command is the same as documented in 
the NOS/VE command interface with the exception that the CHARGE 
and PROJECT parameters are optional {and in fact not useful in 
the current environment since we disable that feature on the NOS 
side). 
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3.0 PROGRAM_INIERFACE_STAIUS 


The 'status!t column indicates whether the procedure is 
unchanged from the previous builds modified From the previcus 
build or not available in this build. Footnotes are numbered 
within each section. 


3.1 CUMMAND PROCESSING 


Procedure afatus 

CLPSSCAN_PARAM_LIST unchanged 
CLPSTEST_ PARAMETER unchanged 
CLPSGETLKEYWORD unchanged 
CLPSGET_SET_COUNT unchanged 
CLPSGET_LVALUE_COUNT unchanged 
CLPSTEST_RANGE unchanged 
CLPSGET_VALUE unchanged 
CLPSCREATE_VARTIABLE unchanged 
CLPSOELETE_VARIABLE unchanged 
CLPSREAD_VARIABLE unchanged 
CLPSWRITE_VARTABLE unchanged 
CLPSSCAN_COMMAND_FILE unchanged 
CLPSEND_USCAN_COMMAND_FILE unchanged 
CLPSSCAN_LCOMMAND_LLINE unchanged 
CLPSCREATE_LFILE_CGNNECT ION unchanged 
CLPSDELETE_LFILE_CONNECTION unchanged 
CLPSPUSH/POP_UTILITY unchanged 
CLPSGET_COMMAND_ORIGIN unchanged 
CLPSGET_LDATALLINE unchanged 
CLPSSCAN_PROC_ DECLARATION unchanged 


362 MESSAGE GENERATOR 


Procedure atatus 

QSPSFORMAT MESSAGE unchanged 
OSPSSETLSTATUS_ ABNORMAL unchanged 
OSPSAPPEND_STATUS_PARAMETER unchanged 
QOSPSZAPPEND_STATUS_INTEGER unchanged 


Cycle 7s July-August 1982 


oa hh we we 


7 422 
NOS/VE Cycle 7 Heaipful Hints 
. . oe | 0941 4/82 
3.0 PROGRAM INTERFACE STATUS 
3.3 RESQURCE MANAGEMENT 


343 RESOURCE MANAGEMENT 


Procedure atatus 
RMPSREQUESTUMASS_STORAGE unchanged 
RMPSREQUEST_LTERMINAL 


All terminal attributes can be specified on the 
RMPSREQUEST_LTERMINAL call but only the following are operational: 


auto Input 
transparent mode 
promot file 
prompt ustring 


oo o 6 


Files assiqned to a terminal device 
Following BAM recuests: 


unchanged 


can be accessed via the 


9 AMPSOPEN 

o AMPSGET_LNEXT 

o AMPSGET_DIRECT 

o AMPSGET_PARTIAL 

o AMPSPUT_NEXT 

Oo AMPSPUT_ DIRECT 

o AMPSPUT_ PARTIAL 

o AMPSCLOSE 

o AMPSREWIND 

o AMPSSKIP 

o AMPSSEEK_DIRECT 

PROGRAM_EXECUTION 

Procedure Status 

PMPSEXIT unchanged 

PMPZEXECUTE unchanged 

PMPSTERMINATE unchanged 

PMPSAWATT_TASK_ TERMINATION unchanged 

PMPSMODULE_LTABLE_L ADDRESS unchanged 

PMPSENTRY_POINT_UTABLE_ADDRESS unchanged 

PMPSPUSH TASK _DEBUG_MODE unchanged 

PMPSSET_LTASK_DEBUG_ MODE unchanged 

PMPSTASK_DEBUG_MODE_ON unchanged 

PMPSSET_LDEBUG_RING unchanged 

PMPSDEBUG_RING unchanged 

PMPSCHANGE_DEBUG_LIBRARY_LIST unchanged 

PMPSPOP_TASK_DEBUG_ MODE unchanged 
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PROGRAM COMMUNICATION 
Procedure 


OSPSAWATTLACTIVITY COMPLETION 
PMPSDEFINE_QUEUE 
PMPSREMOVE_QUEVE 
PMPSCONNECT_QUEUVE 
PMPSDISCONNECT_LOQUEUE 
PMPSSEND_TO_LQUEUE 
PMPSRECEIVE_FROM_QUEUE 

PMPS STATUS. QUEUE 
PMPSSTATUS_OUEUES_DEFINED 
PMPSGETLQUEVE_LIMITS 


CONDITION PROCESSING 
Procedure 
PMPSESTABLISH_CONDITION_HANDLER 


PMPSDISESTABLISH_COND_HANDLER 
PMP$CAUSE_CONDITION 
PMPSCONTINUE_TO_CAUSE 
PMPSTEST_CONDITION_HANDLER 
PMPSVALIDATE_PREVIOUS_SAVE_AREA 
PMPSESTABLISH_DEBUG_OFF 

OS P#SET_STATUS_FROM_CONDITION 


PROGRAM_SERVICES 
Procedure 


PMPSGENERATE_LUNIQUE_NAME 
PMPSGET_LTIME 
PMPSGET_MICROSECOND_CLOCK 
PMPSSETLTASK_CP_TIME 
PMPSGET_DATE 
PMPEGETLUSERLIDENTIFICATON 
PMPSGET_LACCOUNT_PROSECT 
PMPSGET_JOB_NAMES 
PMPSGET_JOB_ID 
PMPSGETLJOBLMODE 
PMPSGET_LPROGRAM 
PMPSGET_UTASK_ID 
PMPEMANAGE_ SENSE _SWITCHES 
PMPSGET_LOS_VERSION 


atatus 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


aiatus 


Sa 


09714/82 


Added support of detected 


uncorrected error 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 


status 


unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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327 PROGRAM SERVICES 


unchanged 


PMPSGETLUPROCESSOR_LATTRIBUTES 
PMPSDEFINE_ DEBUGLENTRY unchanged 
PMPSGET_DEBUG_LENTRY unchanged 
PMPSMODIFY_DEBUG_LENTRY unchanged 
PMPSREMOVE_DEBUG_LENTRY unchanged 
328 LOGGING 
Procedure aiatus 
PMP$LOG unchanged 
PMPSLOG_ASCII unchanged 
3.9 EILE_ MANAGEMENT 
Procedure oiatus 
Sequential Access unchanged 
Byte _Addressable Access unchanged 
Record Access unchanged 
Segment Access unchanged - ¥*1 
ViSystem Srecified unchanged 
V_User Specified unchanged 
U_ System Specified unchanged 
U_User Specified unchanged 
F System Specified unchanged 
FL UUser Specified unchanged 
AMPSDESCRIBE_NEW_LFILE deleted 
AMPSFILE unchanged 
AMPSGET_LFILE_ATTRIBUTES unchanged 
AMPS3FETCH unchanged 
AMPSSTORE unchanged 
AMPSCOPY_FILE unchanged 
AMPSRENAME unchanged 
AMPSRETURN_FILE new name 
AMPSOPEN unchanged 
AMPSCLOSE unchanged 
AMPSFETCH_ACCESS_INFORMATION unchanged 
AMPSSKIP unchanged 
AMPSREWIND *2 
AMPSWRITE_END_PARTITION unchanged 
AMPSGET_LNEXT unchanged 
AMPSGET_LDIRECT unchanged 
AMPSGET_PARTIAL unchanged 
AMPSPUT_LNEXT unchanged 
AMPSPUT_DIRECT unchanged 
AMPSPUT_LPARTIAL 


unchanged ~- *3 
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*1 


#2 


*3 


AMPSSEEK_DIRECT . unchanged 


AMPSGET_LSEGMENT_POINTER unchanged 
AMPSSETLUSEGMENT_EQI unchanged 
AMPSSETUSEGMENT_ POSITION unchanged 
AMPSSETLULOCAL_NAME_ ABNORMAL unchanged 
AMPSSETLFILE_LINSTANCE_ ABNORMAL unchanged 
AMP3ACCESS_ METHOD unchanged 
AMPSFETCH_ FAP _POINTER unchanged 
AMPSSTORE_FAP_PNINTER unchanged 


Segment access IF a sagment access file is written and an 
AMPSSETLSEGMENTLEDIT is not issued to record the EOI, ENI 
remains zeroe The highest page referenced is not yet used as 
the default ENI. This particularty affects those who wish to 
make heaps permanent because EQI is always zero for a heap. 


AMPSREWIND The WAIT parameter on the orocedure call is not 
supported. 


AMPSPUT_LPARTIAL PUT_PARTIAL with the TERM_OPTION = 
AMCSTERMINATE does not act as a put lnext if a preceding START 
was not issued. 


3.10 PERMANENT FILE_MANAGEMENT 


Procedure atatus 

PFPEDEFINE unchanged 
PFPSATTACH ; unchanged 
PFPSPURGE unchanged 
PFPSCHANGE unchanged 
PFPSPERMIT unchanged 
PFPSDELETE_PERMIT unchanged 
PFPSDEFINE_CATALQOS unchanged 
PFPSPURGE_CATALNG unchanged 
PFPSPERMIT_ CATALOG unchanged 
PFPSDELETE_CATALOG_PERMIT unchanged 


Zell MEMORY MANAGEMENT 


MMP3ADVISE_IN unchanged 
MMPSADVISE_DUT unchanged 
MMPSADVISE_OUT_IN unchanged 
MMPSWRITE_ MODIFIED_PAGES unchanged 
MMPSCREATE_SEGMENT unchanged 
MMPSDELETE SEGMENT unchanged 
MMPSSTORE_SEGMENT_LATTRIBUTES unchanged 
MMPSFETCH SEGMENTLATTRIBUTES unchanged 
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MMPSVERTIFY_ACCESS unchanged 

MMPSPFREE unchanged an 
MMPSLOCK_PAGES number of locked pages per 
MMPSUNLOCK_ PAGES segment restricted te 32 
MMPSFETCH PVA_LUNWRITTEN_PAGES unchanged 


3e12 STATISTICS FACILIry 


SFPSESTABLISH STATISTIC unchanged 
SFPSENABLE_STATISTIC unchanged 
SFPSDISABLE_LSTATISTIC unchanged 
SFPSDISESTABLISH_ STATISTIC unchanged 
SFPSEMIT_STATISTIC unchanged 
SFPSEMITLUSYSTEM_STATISTIC unchanged 


3013 INTERACTIVE FACILITY 


IFPSTERMINAL unchanged 
IFPSFETCH TERMINAL unchanged 
IFP$STGRE_TERMINAL unchanged 
IFPS$GET_LDEFLT_TERMINAL_ATTRIBUTES unchanged 
IFPEGET_LTERMINAL_ATTRIBUTES unchanged 
ITFPSADVANCE new ~- ¥*1 


*] Only the option ITFCSADVANCE_LALL_CUEUED_BDUTPUT is supported. 
3214 NOSZVE_EXCEPTIONS 


The following summarizes the exception code ranges currently 
ass igqned to NQOS/VE. These code ranges represent aie finer 
breakdown than the one specified in the SIS for internal NOS/VE 
development purposese Howevers it is important to remember that 
oniy the product identifiers documented In the SIS may appear in 
error messages. 


Common Modules 929000 - 93999 
Common Code Generator By000 - 83999 
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Product 


” Exception Code Identifier Product Name 


1 - 15859999 Reseryed 
1599900 =—- 1595999 SY System Core 
1609006 —- 169999 AM Rasic Access Methods 
16099000 —- 1635999 RA Basic Access 
1643000 —- 1649999 LN Local Name Mgr 
16539000 — 16539999 JF Job File Mgr 
166,000 — 15665999 SR Conversion Services 
167,000 - 167599 CM Configuration Mgmt 
1702000 — 1799999 CA- Command Language 
1809900 - 1899999 JM Job Management 
19029000 — 1993999 LL Loader 
2009000 =— 2099999 MM Memory Management 
2009000 =— 2049999 MM Monitor Level 
29053000 — 2053999 MM Task Level 
2102000 —- 2195999 os Operating System 
2109000 —- 2105999 nS os 
2119000 — 2113999 MT EXEC 
2129000 — 2125999 T9 MS I/0 
2132000 — 2135999 19 Tape I/9 
2149000 -—- 2145999 DM Device Management 
2159900 — 2159999 ML Memory Link 
2163000 —- 2159999 IF Interactive 
2179000 — 2179999 T™™ ™ Monitor 
2189000 — 2185999 ™ ™ Task 
2199009 —- 2199999 JS Job Swappers 
2209000 =— 22959999 PF Permanent File 
Management 
221590008 — 22153999 ST Set Management 
2229000 =— 2229999 PU Permanent File Utilities 
2309000 — 23959999 PM Program Management 
2409000 2499999 RM Resource Management 
2502000 2599999 oF NQperator Facility 
2609000 26939999 AV User Administrator 
2709000 2799999 Ic Interstate Communication 
28029000 2899999 RH Remote Host Facility 
2909000 2999999 ac Object Code Utilities 
300,000 3093999 DB Deadstart/Recovery 
3199099 3195999 MS Maintenance Services 
3209000 3299999 Reserved 
340000 349,999 SF Statistics Fac. 
3309096 3399999 US User Errors 
500s 000 5099999 AA Advanced Access Method 
5103000 5193999 AG ALGOL 
52099900 52959999 AL Assembly Language 
5302000 53939999 AP APL 
5402000 54939999 BA BASIC 
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55039000 5592999 cA Conversion Aids System 
5609000 5699999 cB COBOL 

570,000 5799999 CY CYBIL 

580,000 5899999 FT FORTRAN 

5903900 5993999 PA PASCAL (Wirth) 

6002000 6099999 Pi PL/1 

6102000 6199999 SM Sort Merge 

6202000 6293999 aG Source Code Utility 
6402000 —- 64939999 DB Nebug 
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4.0 DUAL STATE DEADSTART AND OPERATION 


4.0 QUAL_SIAIE_DEADSIARI_AND_OPERATION 


4.1 CURRENT DUAL STATE CONFIGURATION 


The Arden Hilts $2 development systems are configured 


with three FMD units. 
o FMD Unit 43 


This unfit contains NOS voermanent files. 


o FMD Unit 41 
This unit contains the following: 

- Files required to deadstart dual state Cycte 53 
(5.3 plus changes necessary for Cycte 5),y CTI» 
binariess and NOS Deadstart files. 

-~ It is aiso used as a temp device, 


o FMD Unit 42 


This unit contains NOS permanent files. 


o FMD Unit 44 
This is another NOS PF device. 
o FMD Unit 45 


This is another NOS temp device, 


4.2 USER NAMES _AND_ PERMANENT _ELLES 


to run 


A170 NOS 
MSL», EI 


1) The convention used for creating user names on NOS/VE Is as 


follows: 
o Your user name will be your initials. 
o Your password wild be these 3 fetters followed 


by the 
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fetter txt, 
o You must sea COMSOURCE (RBeKe Cooper — x309?) to be 
assigned a user Index 


2) PF dumping and Iaading 


You may use "SES.DUMPPF™ on SN/191 to dump your permanent 
files to tapes and then load them onto your user name on A170 
NOS using “SES.LDADPF™. Documentation on how to use these SES 
procedures and what their parameters are is included in the 
SES User's Guides or they can be obtained by typing: 


SESsHELP.DUMPPF and SES»HELP.LOADPF, 
463 [Q_RELOQAD_CONTROLWARE_EOR THE _NOS/VE_DISK_DRIVER 


At deadstart time NOS will automatically toad 7155-1x disk 
controlware on one channel with controlttier type=FM (LBC CMRdeck 
entry)s and will automatically load 7155-4x disk controlware on 
any channel with controller type=HT (LBC CMRdeck entry). NOS/VE 
supports both of those types of controllers. NOTE: It is not 
possible to use 844 half-track controlware in this environment. 


4o4 ALZO_NOS_DEADSTART 


4e4el CTI AND CHECKING CENTRAL MEMORY 


Deadstarting A17C NOS assumes some knowledge of CTI. CTI 
stands for Common Test and Initialization. It is software that 
places an 800 series machine in a state such that it is possible 
to deadstart an operating system. CTI is used somewhat 
ambiguously in the software community to impiy CTI and MSL 
(Maintenance Scftware Library). The MSL is a collection of 
programs and data that includes such things as a subset of CMSE 
(Cyber Maintenance Software Executive) that enables one to toad 
controtware to controilersy» Jook at CYBER 180 maintenance 
registers, look at microcodes etc. The MSL also contains 
microcode that can be toaded by CTI. The MSL is actually an 
operating system that runs independentiy of NOS. An important 
element of CTI/MSL Is HIVS (Hardware Verification Sequence), 
which is a program that tJoads microcodey clears and checks 
central memory and tests ail 170 opcodes. If you are not sure 
what the machine was used for (particularity the first hands on 
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user each morning) then the HIVS program should be rune This is 
accomplished by? 


1) deadstart to NOS/VE (unit 40 for $3s unit 41 for $2) 
2) Enter 0 (operator intervention) 
3) Enter P (deadstart panelsmake sure level 0 deadstart) 
4) <BKSP> 
5) Enter H (assure jourseie that CS=YES to reload microcode) 
6) <BKSP> 
7) Enter V (verification sequence) 
8) Hit <CR> at ‘parameter displayt to test CM & CP 
When you see text that tells you that verification is complete 


and a deadstart Is requireds you are now ready to deadstart NOS, 


424.2 NOS DEADSTART 


See Section 3.3 of the Integration Procedures Notebook for 
important NOS CMPDECK changes. 
o Set the O/S panel to deadstart from the primary system diske 
This is Unit 41 for all Cycle 5 systems. 
o Push D/S button 
o Enter (CR) 
o Enter date/time 


Wait For deadstart to complete. 
Note: The deadstart tape DUALS (which is currently instalited on 


unit 41) is found in the area in the northeast corner of the $2 
fab where the tape cabinet Is found. 


4.5 NOSZVE_DEADSTART_AND_INSTALLATION 


o Enter DOWNsCH2. so NOS/VE can use the channel. 


o Enter DOWN»sCH32. so NOS/VE can use the channel. 
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9 


The following file must be availahte in your catalog on the 
$23 


TPXXXK contains a NOS/VE deadstart image. This must be a copy of 


the 


dual state deadstart timages availabie from the link 


procedures, 


.¢) 


If youtye never deadstarted NOS/VE from the user number from 
which you want to run or if you wish to change the current 
Parameter settings for your particular user numbers then do a 
SETVE. SETVE assumes the File TPXXXK is in your user number; 
you do not heave to do another SETVE if TPXXXK has changed 
Since the last time you ran. The general form of SETVE iss 


XeSETVECPN=FEFF,UNeunsC=6) 


where fFFFF is an identifier of up to 4 characters and un is 
the user number to search first for files. 6 is the number of 
the system core command deck for the Arden Hillis $2 
configuration. Warnings Seoecifying C=O on the Arden Hills. 53 
wilil_destroy the closed shop permanent file bases. In general 
ffFfFF and un will be the sames e.g. XeSETVE( DAH» UN=DAHsC=6) 


**kOniy ONE SETVE should be dene for each user number and a 
SETVE should NOT be done for ANY Integration user number 
except by the Integration project.** 


SEE SECTION 5.1 FOR MORE DETAILS. 
Bring up dual state: 
NVEFFFF. 


where fF TF is the identifier specified in SETVEs e@egs 
NVEINT1. 


Bring up the Qperator Facility 
Enter KaNVE. 


NOS/VE is currentiy generated and initialized on both NOS 
and NOS/VE. All source and object !ibraries that make up the 
NOS/VE system ar2 produced on NOS and therefore must be 
converted from their Ci te II counterparts. Other parts of 
installing and initializing the system {(e.Ge buitding the 
S$SYSTEM catalog) are performed by command language procedures 
on NOS/VE. Since the same system will many times In a closed 
shop environments» it is advantageous to only perform the 
conversion From CI to [I a single times; save the resuits in 
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the NOS file system and then simpity bring the files back 
during deadstart. 


The actual files that get instalied and loaded on each 
deadstart are determined by a command language procedure (the 
system profile) interpreted on NOS/VE. This procedure can be 
modified by each site to initialize their NQOS/VE environment 
in the most suitable fashion. The process of building the 
system profile and of performing the CI to II conversions is 
referred to as an installation deadstart and the psrocess of 
executing the system profile and of fetching oreviously 
converted files from NOS and making them availabie in the 
NOS/VE file system is referred to as a deadstart. A single 
command is avaitable to perform both an installation deadstart 
and a deadstart. 


4.521 THE DS PROCEDURE 


The puroose of this command is to perform an installations 
normal or recovery deadstart of NOS/VE. The defaults for 
parameters are those most convenient for "™closed shop” 
deadstarts. 


The procedure "brings up™ the job tog display on the left 
screen where the progress of the procedure may be watcheds and 
the contro! point display on the right screen. Just before 
the procedure completes it changes the left screen to display 
the system iog and writes to that log the message: 


t---— Deadstart Completed ----! 


at which point the operator may enter commands. 


ds C(kind=install } normal { recover] 
Caet_source_libraries=<boolean>d] 
Caet_products=<booleand] 
Cecho=<boolean>] 
Calternate_user=<NOS_user name>] 
{save_instali_files=<hboolean>d] 
Cvalidate_users=<hboolean>] 
Cquick_validate=list of <name>] 
Cdebug=<Xboolean>] 
Chelp=<file referenced] 
Cstatus=<status variable>] 


kind i ki This parameter specifies what kind of deadstart is 
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to be performed. Valid specifications are: 

instaii ! i - installation deadstart to be performed. 
The system Jibraries are built from CI object 
Files. 

normal in- normal deadstart to be oerformed. The 
system libraries are obtained from the results of a 
previous installation deadstart. 

recover { rf - recovery deadstart. Just initiates system 
tasksSe Permanent files are "recovered”™ from a 
previous run of the system. 


Qmission will cause a recovery deadstart to be 
performed. 


get_source_libraries ¢{ gsi: This parameter specifies whether 
SCU libraries are to be installed. Valid specifications 
are: 
true ! yes } on — libraries are to be Installed 


faise ! no : off - libraries are not to be instalied 


Qn the Arden Hills closed shop $2 systems the SCU 
libraries to be installed are? 


QSFPIL -—> OSFSPROGRAM_INTERFACE LIBRARY: operating system 
' program interface 


OSFSL => OSFSSQURCE_LIBRARY: subset of operating system 
source library 


Omission will cause SCU libraries to be Installed. 
get_oroducts i gp: This parameter specifies whether the object 
libraries defining the current product set are to be 
installed. Valid specifications are: 
true } yes §} on ~ the products are to be instalied 


faise {| no 3} off = the products are not to be installed 


On the Arden Hilts closed shop $82 systems the product 
set to be instalied consists of? 


CYFIIC -> CYFSCOMPILER: cybil II compiler 
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CCFRTL -> CCFSRUN_TIME_LIBRARY: comnon compiler modules 
run time tibrary 


MLFRTL -—> MLFSRUN_TIME_LIBRARY: math run time library 
DBFDL => DBFSDEBUG_LIBRARY: symbolic debug library 
SCFOL -> SCFSOBJECTLLIBRARY: source code utility 


SCFCL -> SCFSCOMMAND_LIBRARY: source code utility 
“stand-alone” command library 


IFFEDIT => TFFZEDITOR: Jack Bohnhoff's editor (JEDIT) 
Qmission will cause the product set to be Installed. 
echo ; e? This parameter specifies whether the commands should 
be echoed to the censole during execution. Valid 
specifications are? 
true i yes ! on -— echo commands 
false i no + off - do not eche commands 
Qmission will cause commands not to be echoed, 
alternate user } au: This parameter specifies what NOS user to 
check if the default NVE user does not have the needed 
filee Any NOS user name is allowed. 
Omission will cause INTL to be usede 
save_instali_files ! sift: This parameter specifies whether to 
save the system libraries created by an installation 
deadstart. This parameter is ignored for a normal or 
recovery deadstart. Valid specifications are: 


true } yes | on -— save the installed system libraries 


faise {${ no : off - do not save the Instaifted system 
libraries 


Onisston will cause the files not to he saved. 
validate users i vu: This parameter specifies whether to run 
the job that validates NOS/VE users. This parameter is 


ignored for a recovery deadstart. Valid specifications 
are: 
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true } yes } on - run the validation job 
false { no } of Ff - do not run the validation job 
Omission wil! cause the validation job to be run. 


quick validate |! ay: This parameter determines which users 
will be validated by the validation job if it Is run. 
When specifieds this parameter gives a list of user names 
to be validated in addition to the users: INTl» INT2>» 
DEVL» DEV2Z» RELI» EVAL and RKC. 


Qmission wilt cause all users to be validated. 


debug id: This parameter specifies whether the procedure 
should abort if an error condition is detected. Valid 
specifications are: 


true } yes i: on -— do not abort on an errore The user 
will be prompted for commands in the event of an 
error at which time entering "continue™ will cause 
processing to resume. 


faise 3} no } off - abort on an error 


Omission wil) cause the orocedure to abort when an 
error is encountered. 


help { h: This oarameter specifies whether help information is 
to be written. If this parameter is specifieds the help 
information will be written to the specified file and the 
procedure will terminate. 


Omission will cause the procedure to execute and the 
help information not to be written. 


status: See ERROR HANDLING in the NOS/VE ERS. 


If you change any of the fotlowlng decks you MUST use the 
installation deadstart from your own catalog (with files 
CYBILSD, XLJOGCMs XLJOSL and XLJLIB),» or you must use the 
alternate_user parameter to specify a NOS catalog containing 
the files (e.g. DEVI). 


AVMUTIL CLMDP DMMDISA ICMCLOS ICMFAI ICMFAPC ICMFLSH ICMGET 
ICMOPEN ICMPUT ICMWEOP IFMEXEC IIMA72H LIMDC2S ITIMRLE 

TIMRSE TIMRUM TIMRUSM TIMTDEL OCMADD OCMBIM OCMBIM OCMCOL 
QOCMCOM OCMCPY OCMCRM OCMDEF OCMDEL OCMDLB OCMONL 
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QCMDOL OCMEND OCMGEN OCMLCH ODOCMLMG OCMLP OCMAUR 

OC MNP OCMOBJ OCMOFH OCMONS OCMRCH OCMRED OCMREP QOCMRMB 
OCMSAT OCMSOL OCMVEL QCMVLU OCMVOL PFMDC PFEMTALL 

PUMBCAT PUMBCYC PUMBFIL PUMBFO PUMBLST PUMBPF PUMBSET 

PUMCOMN PUMCRAK PUMPURG PUMCRAK PUMIOBF PUMLIST PUMMISC 

PUMPURG PUMRALL PUMRCAT PUMREC PUMREF PUMRFIL PUMRPF 

PUMSTUB RHMLML RHMOAT RHMQDP RHMORE RHMSFM USORT UTMDUR 
UTMPC1 UTMPC2 UTMPC3 UTMPC4 UTMPCS UTMTSA WUUSERI 


44502 EXAMPLE OF NOS/VE INSTALLATION DEADSTART 
Type 
Ke NVE. 
KeSETLA (your _unsNVE) your password 
KeGETF DS U=scat 
KeDS INSTALL GSL=NO GP=N0 AU=scat 
4.5.43 EXAMPLE OF NOS/VE VPNORMAL™ DEADSTART 
The Integration system has had the installation deadstart 
run -on it. Also the files produced by the installation 
deadstart have been made semi-private and are found on the 


catalog used in the NVExxxx call. 


Tyoe (where DEV1 is the same as the xxxx in the NVExxxx 


call): 

KeNVE. 

KeSETLA (DEVIsNVE) DEVIX 
K»GETF DS 


KeDS NORMAL 


4o504 EXAMPLE OF NOS/VE RECOVERY DEADSTART 


This is the kind of deadstart that should most frequently 
he done In a "closed shop”™ environment and consequently is the 
one for which all the parameter defaults are oriented, Lt 
presupposes that permanent file recovery has been successful. 


Type (where DEVI is the same as the xxxx in the NVExxxx 
calt): 


Kea NVE. 
KeSETLA (DEVI»sNVE) DEVIX 
KeGETF DS 
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KeDS 


4.505 EXAMPLE OF MINIMAL NOS/VE DEADSTART 


The minimal deadstart shown below may he useful 


developers who need to get the system up auickly and 
need the product set or all validated users. 


Type 
K» NVE. 
KeSETLA (your _un»NVE) your password 
KeGETF DS U=scat 
KeDS NORMAL GSL=ND GP=ND OV=eyour_un AU=scat 
4.5.6 USE OF THE QUICK LDEADSTART COMMAND 


This cemmand is intended as a davelopment 
facilitate 'fast' deadstarts where recovery is not 


do 


ne 


te OS 
net 


tool to 


eded; 


indeed, if this command is entered rpecovery._will_not_be 


Performed when the system is brought down for whatever 
r2asone Specifying this command will cause an instatiation 
deadstart to take place, If the INITDO command Js not 


specified then a default value of 'VSNOO1' is used for the 
system deadstart device. Use of INITOD will altow setting the 
deadstart devices [Identifier to any value. THIS COMMAND WILL 
NOT BE ACCEPTED FROM A [TEADSTART COMMAND FILE» SO '#D=T!? 
BE SPECIFIED ON THE SETVE PROCEDURE TO PERMIT ENTRY OF THE 


QUICKDS COMMAND. 
Format: QUICKDS or QUICK _DEADSTART 
Values: The default is false, Executing this 
command twice will cause the final value to be false. 
Note: QUICK LTEMPLATE_LOAD does not exist now. 


4.6 NOS/VE_INTERACTIVE FACILITY OPERATION 


4e6el OPERATOR INITIATION 


To bring up the NOS/VE interactive facility 
Following: 


1) Bring up NOS/VE. 


MUST 


command 
causes this initial value to be toggled» thus executing this 


do 


the 
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2) 


3) 


Bring up NAM 


At the system console enter? 


FCN» 5s 7700, 
NAMV2. for 32 and $3 


If IAF is not up at control point Ll» enter: 


TAFV2. 


40602 OPERATOR TERMINATION 


To terminate NGOS/VE interective any of the following may be 


done: 


CFOsNAM.DIsAP=VELAF. 


This is the preferred method. To bring NOS/VE interactive 
back ups you must first de a CFGsNAM.LENsAP=VEIAF. | 


CFO»sNAM.DIsNE. 


This terminates the entire network including ITAFsRBFs etc. 


4.623 OTHER OPERATOR CAPABILITIES 


To flogically turn the printer ons under OSD enter: 


ON» 33. 
FORM, 339TM»s- 


To send a “shutdown warnina™ to all terminals ltogged on to 
VEIAF do: 


CFIUesNAMe IDs APHVETAF. 
To send a message to al! terminals do: 
CFOsNAMMSGsALL»smessagee 
PASSGON has the ability to record various types of 
diagnostic information. This capability is controlled via 
the sense switches at the PASSON control point. To turn a 


sense switch on (off) at job gsn do: 
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ONSWs isneox. (COFFSWsjsneaxe) 


where x is the desired sense switch (1 to 6). The PASSON 
default is ali sense switches off.» It will take a short 
period of time before PASSDN detects 4a change in a sense 
switch and reacts to ite The sense switches currently used 
by PASSON are: 


Switch_# use 


1 Network Trace | 
2 PASSON Logic Trace To Dayfile 
3 Memory Link Trace To Dayfile 


4.7 NOS/VE_OPERATOR FACILITY AND_OPERATOR COMMANDS 


With the release of the Operator Facility Phase 1 several 
changes to the NOS/VE Operating System will occur that will 
effect the users of the NOS/VE Operators Console. The 
Qoerator Facility runs as part of the NVE control point. When 
the request for K display appears on the NOS 8B Displays assign 
the K Display to the NVE control point. The Operator Facility 
is capable cf displaying both a left and a right screen area 
at the same time, If the operator wants both screens then 
type in KK. The contents of these displays are determined by 
the commands entered by the operator. 


The fteft screen is divided into four different areas, The 
top most area is the system header which contains the current 
date and times memory statisticss and an operator action 
message if one is posted. The operator action will include 
the job sequence number of the owner of the message and 
"message cancelled! if the message is canceltied because the 
task has terminated. The next fine contains the first 64 
characters of the operator action message (60 characters in 
stand alone). 


The next area of the screen is the main output area. This 
area has the fite name of OUTPUT. Any display command can 
have its output directed to this area as weil as any system 
command. 


The third area is towards the bottom of the screen. This 
area is two fines fong and contains the response area. This 
wid l contain error messages from system commands, The area is 
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cleared when the next operator typein is entered at the 
operator's console and received by NOS/VE. 


The fourth area is the prempt area. This wii! contain the 
status of the keyboard. If NOS/VE is processing a commands 
then the keyboard is locked and all typeins will be ignored. 
When the keyboard is lockeds the message ‘data received by 180 
- keyboard locked' will appear at the screents bottom. when 
the keyboard is unlocked then any data in the keyboard buffer 
wilt be sent to NOS/VE. The bottom line is the fast !ine that 
was processed by Qeerator Facility. 


The right K Display has the file name GUTPUT_ RIGHT. There 
is onty one area on the right screen therefore the main 
display area is 160 lines longer than the feft screen area. If 
a dayfilte display or CP display is shown on the right screen 
you wili get more lines of information than on the tleft 
SCrean.s 


There are no default displays that come up automatically on 
either output display area. It is up toe the operator to 
decide the display the operator wishes to see. The only parts 
of the display that cone up automatically is the system header 
display and the prompt area for keyboard status. 


The page width of the screen is 60 characters for 
standalone and 64 characters for dual state. The character 
set translation code is the same as that for the current NVE 
Subsystem contro! pointe The escape code sequence for the 
special characters to be typed has not changed. There are a 
few differences in the processing of data hy the Qperator 
Facility anc NVE Subsysteme 


1) Do NOT end commands with 23 period. Periods are sent to 
NOS/VE. 


2) The NVE subsystem commands that begin with an asterisk will 
not be supported from the Operator Facility control! point. 
If these commands are entered fron the Operator facility 
they will be passed on to SCL where an illegal command will 
be issued. 


3) Routing of console job data to a specific job by the 
*n=command'!' protocal will not te supported in dual state. 
This feature should work in standalone but will not be 
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supported. 


4) No type ahead - commands cannot be entered until the prompt 
area shows that they are requested. 


There is one new command to replace the current display 
commands. The entry points for Zdis»s Zdisbs and Sdis have 
been deleted. The new command is VEDISPLAY and has two 
parameters. The oaptions are tisted below. The values in 
paranthesis are the abbreviations. Note that this command 
does not begin with an asterisk (*). This command will be 
processed by SCL and create a new system contro! point task to 
display it's data. The user can have the same display type on 
each of the display areass if the user so desires. 


Command Name Display Type Screen Area 
Parameter Name Parameter Name 
DISPLAY _DPTIONS QUTPUT (0) 


OLTSPLAYLOPTION (99) 


Parameter Values Parameter Values 
VEDISPLAY (VED) DISPLAY_SYSTEM_LOAG OUTPUT 
JOB8_LOG (JL) GUTPUT_LRIGHT (OR) 
CONTR OLLPOINT (CP) 
The default file name for al! displays is OUTPUT. 


The following is a brief iist of commands to bring up NOSVE 
with the Operator Facility installed. 


NVE FFF. to bring up NOS/VE. (See Section 5) 
KaNVE~ 

KK » to bring up the K display on both = screens. 
KeVED JL to bring up the job fog. 

or 


KeVED DISPLAY _SOPTIONS=JL QUTPUT=OUTPUT 
to bring up the job tog using key word 
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identifiers. 


KeVED CP OUTPUT_LRIGHT 
to bring up the control point display on 
the right screen. 
or 
KeVED DISPLAY_LOPTIONS=CONTROL_POINT OQUTPUT=OUTPUT_RIGHT 
to bring up tha control point display using 
key word 
identifiers. 


Ke xXx send any command to NOS/VE. 
KeTERMINATE_ SYSTEM te terminate NOS/VE. 


Note: After the DS procedure has completed execution the 
command te enter te bring down the system is TERMINATE SYSTEM, 
not TERMINATE_SYSTEM_JOB. Yess this is the OPPOSITE of what 
it used to be. 


4e7.1 MELETE_JOB_QUEYE | DELETE_LJOB_QUELES ¢ DELJQ 


The purpose of this command is to delete ali files from the 
Job input subcatalogs the print subcataiog or both. This 
command is only allowed from jobs with operator and or system 
privileges. 


delete_job_queue [Caueue_name=Inoutioutputiall] 
C[status=<status vartlable>] 


queue _name { ani This parameter specifies from which 
subcatalogs files are te be deleted, Specifying 
INPUT will cause all files to be deleted from the 
dob swap subcataloa and the job input subcatalogs 
Seecifying OUTPUT will cause all files to be deleted 
from the job cutput subcataiog. Omission will cause 
all to be usede 


status: See ERROR HANDLING. 
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4e7e2 REBUILDLINPUT_L QUEUE | REBIQ 


The purpose of this command is to rebuild an entry in the 
Known Job List (KJL) from information in the System Label of 
the file representing the job being processed. This command 
is to be used during the process of recovering the input 
queues during recovery deadstart. 


rebuild input queue (name=<named]j 
Cstatus=<status variable>] 


name ion: This parameter specifies the file name of the 
file representing the job. An attempt is made to 
process the specified file within the catalog where 
job input queues are known to reside. 


status: See ERROR HANDLING. 
4.7.3 REBMILDLOUTPUT_LQUEUVE {i REBOOQ 


The purpose of this command Is to rebuild an entry In the 
Known Output List (KOL) from =information retained in the 
System Label of the file representing the output being 
processed. This command is to be used during the process of 
recovering the output queues during a recovery deadstart. 


rebuild_output_queue C[name=<name>d] 
[status=<status variable>] 


name: This parameter specifies the file name of the file 
representing the output. An attempt is made to 
process the specified file within the catalog path 
of where job output queyves are known to reside. 


status: See ERROR HANDLING. 


408 ROUTE _AN_INDUT_EILE_EROM Ci7G_TO_(€180 


Through the system consoles enter: 
Type 


XeDIS. 
USERsAsB. 
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GET»yfilename. 
where Filename identifies the Input file te be routed. 
ROUTEsfilenamesDC=LP»FC=RH. 


4.9 CONFIGURATION MANAGEMENT 


In order te run NOS/VE In a dual state environments certain 
hardware configuration rules must be In effect. Al! storage 
devices and channels that NOS/VE will request must be in a 
'down!' state in the NOS EST. For more information on the NOS 
EST» see the NOS Version 1 Operator's Guides 604356005 Section 
4, Refer to the E display. . 


To run $2 S/N 164 in the standard configurations channels 2 
and 32 must be downed as shown below. 


DOWN»sCH2, 
DOWN» CH32. 


4e9el SYSTEM CORE COMMANDS 


Configuration Management (CM) system core commands define 
the system mass storage device, The commands are described in 
detail in the MNOS/VE Installation Command Interface ERS» 


Section 2, Tre CM system core commands define the hardware 
configuration of the system device and the controller 
accessing the system device, An example for $2 S/N 1064 is 


shown here. 


SETOCT $7155_1 
SETDD $885_11 4018) 


4e.9e2 JOB TEMPLATE COMMANDS 


During an Installation deadstarty»s the Physica! 
Configuration Utility (PCU) and the Logical Configuration 
Utility (LCU) must be run. The PCU is run to describe the 
physical configuration that NOS/VE may accesse The LCU will 
logically install all or part of the physical configuration 
and allow NOS/VE to access the equipment. Commands for both 
utilities are described in the NOS/VE Installation Command 
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BPO IE PE ROPE PERO IE POE RE PERE PEPE POPPE BG PEPE PO PEPE PE POPE BE PE PERG OE PH PE POPE PE A PE BE PE PE PE PE POO PE PO PE PEE FE PE PO PE TOTO OTE EN 


Interface ERS» Section 2. 


The system device which was defined by the system core 
commands must the defined via the PCUs using the same 
controller and channel number. Additional devices may be 
defined as tong as the device is in a2 down states and all 
channels defined are aiso down. An example is fisted here. 


EXECUTELTASK SP=MANAGE_PHYSICAL CONFIGURATION 
“SETLMAINFRAME DEFINITION MAINFRAME=S$2 
SETLDATA_CHANNEL_DEFINITION CHANNEL_NUMBER=2 
SETLDATALCHANNEL_DEFINITION CHANNEL_NUMBER#=18 
SET_CONTROLLER_DEFINITION ELEMENT=CT1 eo 

PRODUCTLIDENTIFICATION=$7155_1 +. 
SERTAL_NUMBER=2 CHANNEL _ CONNECT ION=CHANNEL2 
SETLCONTROLLER_ DEFINITION ELEMENT=CT2 2. 
PRODUCTLIDENTIFICATION=$7155_1 o. 
SERTAL_NUMBER=3 CHANNEL _ CONNECT ION=CHANNEL18 
SET_STORAGE_DEVICE_DEFINITION ELEMENT=FMD40_A oe 
PRODUCTLIDENTIFICATION=$885_11 SERTAL_NUMBER=1234 42. 
UNITLNUMBER=40(8) CONTROLLER CONNECTION=CT1 
SET_STORAGE_DEVICE_DEFINITION ELEMENT=FMD40_B 2. 
PRODUCTLIDENTIFICATION=$855_11 SERIAL_NUMBER=3456 .. 
UNITLUNUMBER=40(3) CONTROLLER _CONNECTION=CT2 
INSTALLLPHYSICAL_CONFIGURATION MAINFRAME=S2 
QUIT 


EXECUTE_TASK SP=MANAGE_LOGICAL_ CONFIGURATION 
INSTALL_LOGICAL_ CONFIGURATION INCLUDE=ALL 
Quit 


4.9.3 MULTIPLE VOLUME CONSIDERATIONS 


If a configuration is used defining multiple mass storage 
volumess the execution of the PCU and LCU will only permit 
access to the system device. In order to bring additional 
volumes onlines the LOU must be run againe The user may want 
to initialize a fresh volume. To do thiss use the LCU 
subcommand INITMV. To add a volume to the NOS/VE sets ieee 
to allow NOS/VE use of the volumes use the LCU subcommand 
ADDMTS. An example is shown heree 


EXECUTE_TASK TP=MANAGE_LOGICAL_CONFIGUATION 
INITIALIZE_MS_ VOLUME ELEMENT=FMD40_B RECORDED_VSN="'VSNOO2? 
ADD_MEMBER_LTO_LSET MEMBER _VSN=tVSNOOZ2! 

QUIT 


Cycle 7s July-August 1982 


ae oe 


wi web wet 


4-19 
NOS/VE Cycle 7 Helpful Hints 

| . wt | eee worm nO GEG EZ 
4.0 DUAL STATE DEADSTART AND OPERATION 

40923 MULTIPLE VOLUME CONSIDERATIONS 


0 00 0 P8 BO NE 10 00 10 O88 HO 90 WO 8 DOSE RE OO OO 00 1 0 POE PO 0 Pe Od OO OOOO TE 08 90 PO DO OO TOE MEMO DO WO D0 AOE Od 80 0 00 te One PO te on nn 00 nee eee 


During a noninstailation deadstart»s» an attempt will be made 
to bring all logically configured volumes online and 
reactivate them. This means the above sequence need only 
occur when a new volume is being brought online the first 
time. 


Reference has been made to the NOS/VE Instailation Command 


Interface ERS. To aet acopy of this document on S/N 101» 
enter SES»sMAND.LISTNIH,. 


4410 K_ DISPLAY As cit 


Support of 6-12 ASCII from the console (K display) causes 
the following changes: 


INPUT ITRANSLATED_TO INPUT IRANSLATED_1TD 

4/1 7{ [ 

#2" 4) | 

/3 # /+ > 

14 % {- < 

45 (reversed /) = * 

16 3 * ' (singie auote) 
oe ae // / 

18 < /» : 

4/9 } 4A to /Z a- 2 (lower case) 


/O0 — (underscore) 


4.11 £OD_AND_DSDI_INEQRMATION 


Most of the steps tisted here are used to gather 
information for recovery problemss etc. If you do not wish to 
do thiss execute steps D and E only (EDD dump and NOS tfevei 3 
deadstart). 


Ae Enter DR I at the MDD display. 

Be. Enter HP at the MDD display. 

Ce. If INU.FS1 NOT = 6 DR TOU.FS2 NGT = 0 THEN do NOT enter 
DU at the MOD display ELSE doa enter DU at the MDD 
displaye 
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D. Press deadstart button and perform EDD: 


1) Mount scratch tape (ring in) on a 9-track drive. 


2) Push D/S button. 

3) Select U (utilities) display. 
4) Select & (EDD) display. 

5) Set channel ($2213). 


6) Set ECU (S$2=01luu) 


FE = equipment 
C = 1 for 67% drivess 2? for 66X drives 
uu = unit number of the tape drive to be 


7) Answer “dump number™ with a CR. 


8) Answer "non zero inhibits renwind™ with a CR. 


uséde 


9) Answer "channel controiware” with a CR. warning: 
if this step Is omitteds OSDI canot process the 


dump tapee 


Ee Perform a fleve! 3 NOQS deadstart (See Section 4-13). 


Fe If you are running on the $3» enter the following at the 


console: 


X.O0IS. 
USERsINTIsINTIX. 
GETs»sDMPDFS/UN=JLG. 
BEGIN» » DMPDFS. 


° 


DROP » 


This is a procedure to dump several dayfiles associated 
with the NVExxxx job and are needed aiong with the EDD tape to 


adequately debug a NOS/VE hana. 


Some of the crashes that NOS/VE encounters will 


cause 


NOS/VE to terminate such that the operator will notice the 
K-display which requests that a Ke*RUN. be entered. Before a 
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K*RUN,. is entered the EDD should be parformed,. 

To create a listing of the EDD tapes type SES»INTI.DSDI See 
the procaduretls HELP documentation for parameter 
descriptions. 


C178 OSDI information can be found in Chapter 10 of the NOS 
SYSTEM MAINTENANCE Manuale © . 


A170 DOSDI info can be found in document ARH3060 -- GID for 
A170 NOS/S2. 


4ei2 NOS/VE_TERMINATION 


© Bringing down dual aeates 
Ka NVE. 
KeTERMINATE_SYSTE™ 

o If not a normal termination 
Ke NVE. 
Ke *RUN. 


Ke ®ENDLST. 
Ke *ENDRUN. 


4013 ALZO_NOS_SHUTDOWN 


Before leaving the machines it is necessary to bring NOS 
downe Tf NOS has crasheds a tevel 3 deadstart must be 
attempted even if the only reason is to bring NOS down. To do 
a ijeve!l 3 deadstarts: 

1) Push D/S button 

2) Select "0" display 
3) Setect "PP" display 
-4) Enter 1T=3 


5) Enter (CR) 
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6) Enter date/time 


If a dump is desired but a crash has not occurred STEP. 
should always he entered before pushing the deadstart button. 
After the dump has been taken a f!evel 3 deadstart should he 
performed. 


To bring NOS downs do the following: 
1) Enter: 
CHE 
The screen will display: 
CHECKPOINT SYSTEM. 
Enters: carriage return 
2) Make sure no mass storage device has a4 checkpoint 
rquested. To do thiss enter? EsM. If the display shows 
there are no "C™"s in the status fields then all devices 
are checkpointed and vou may continue, 


3) Enter: 
STEP. 


4) Push deadstart button. 
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Del SETVE_FQRMAT 


The general format of the SETVE command is 


Xe SETVE( PN=FFFFE » UN=UNns VSN=VSN» D=d» P20 B=bs C=C9CH=ch) 


FFF 


un 


jis a string of neo more than four characters. SETVE 
appends FFFF to 'NVE' toa construct the nane of 2 
procedure file whichs when invokeds wil! deadstart 
NOS/VE. The default is TST. 


specifies the user number from which TPXXXK is 
attached. Un is the first catalog searched for 
other Files used in deadstarting and terminating 
NOS/VE. The default is INTI. 


specifies the deadstart command deck to be used when 
deadstarting NOS/VE. The function served by the 
deadstart command deck is analogous to the function 
served by the CMRDECK of NOS. Currently supported 
values for c and their respective uses are: 


Arden Hillis $3 S/N O02 opan shop/hands-on time 
Arden HIfis $3 S/N 02 closed shop 
Arden Hills S2 S/N 104 open shop/hands-on time 
0 Sunnyvale S2 ciosed shop installation 
¢) Sunnyvale $2 closed shop continuation 


ee OW re 


The default is set in the file CMDS1. Currently 
the default is 6. Warningi Specifying C=o__on the 
Acden__Hilis..33. will. cdestroy the NOS/VE_ permanent 
file_basee_ 


specifies an alternate catalog to be searched “For 
the various files used in deadstarting and 
terminating NOS/VE. The default is INTl. 


is used to indicate that the system core command 
processor should accept commands from the consoles 
Specifying D=T In the SETVE command allows the 
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oOperater to enter commands from the console after 
processing the deadstart command deck, If the 
ooerator wishes to initialize the system device 
and/or install a new version of NOS/VE» D=T must be 
specified. The default is set in the file CMDSI1. 
Currentiy the default is D=F. 


p specifies the password for the catalog indicated by 
the un parameter. If this parameter is omitted the 
password will be generated by appending an 'X' to 
the UN parameter. 


ch specifies the octal chanrel to be used for NOS/VE 
disk 1/0. The default is set in the file CMDS1. 
Currently the default is 2. 


vsn specifies the vsn of a deadstart tape. If this 
parameter is used then NOS/VE will be deadstarted 
from the tape specified. If it is omitted, then 
NOS/VE wil! be deadstarted from the permanent file 
TPXXKK. 


Se2 2EIVE_USAGE 


Earlier versions of NOS/VE required that two SETYVE commands 
be issued if the system was to be Installed and subsequently 
recovered. The current system does not require this. The 
oniy reason for issuing two SETVE commands is to provide a 
deadstart procedure that does not require/permit operator 
intervention. 


It should be noted that once the SETVE command has been 
issueds it need not be issued again unlessesre 


1) There is a need to change one or more of the parameters 
specified in SETVE. 


2) The command files NVEFfFfffs», generated by the SETVE 
command is purged from the system. 


Two examples of SETVE usage and subsequent NOS/VE deadstart 
are given below. The first example shows a "hands on™ user 
working with recovery. The second illustrates these concapts 
for atypical NOS/VE closed shoo. This writer hopes that the 
reader will find both examples useful and illuminating. 


Ye. A “hands on™ user 
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The 
by tyo 


X 


Sev 
noting 


1) 


2) 


command file NVERSOD Is built and installed in NOS 
ing 


oe SETVECR SDs UN=RSD os VSN=TAPEs B=DEV1sC =65D=T) 


eral of the choices of parameters are worth 


By specifying the VSN parameter the user has built 
a command file that will deadstart the system 
directly from the tape produced by MVESYS., 


The user in this exampte has specified deadstart 
command deck 6 (C parameter) and has allowed the 
NOS/VE disk 1/9 channel (ch parameter) to default 


-to 2. Nne concludes that the user is running on 


3) 


" Nos 

N 

at the 

The 

K 

Pre 
and th 
comman 
WSECP 
USEIP 

SETOCT 
SETDD 

The 


Ke INIT 


the Arden Hills $2. 


The user has specified D=T, This is important. 
The deadstart command which triagers instatlation 
of a recoverable system cannot be read from a 
deadstart command deck. Tt must be entered from 
the console at deadstart time. Specifying D=T 
allows the operator to enter commands from the 
console. 


JVE is deadstarted by typing 

VERSD. 

console. 

user brings up the K display by typing 
gy NVE. 
sentiys the deadstart command deck is displayed 


e user is prompted for inpute The deadstart 
d deck used in this exampte looks like this: 
S2CFIG 
EMPTY 
$7155 _1 


S2e5.12 32 
user types 
DD VSNOO1. 
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tI. 


KeGD-e 


The system accepts the commands and instails and 
deadstarts NOS/VE-. 


After the system comes downs via either controlied 
termination or a crash» the system can be recovered (if 
necessary) and redeadstarted by typing 


When the deadstart command deck is displayeds the, 


user types 
GO. 


This will cause NOS/VE to be deadstarted without 
Initializing the system device. 


A typical “closed shop" 


Two command fliess NVECLSH and NVEINST»s are created 
by typing 


Xs SETVE(CLSHs UN=CL SH» B=DEV19C=40sCH=1) 
Xs SETVE CINSTs UNECL SH» B=DEV1s C=109CH=19D=T) 


Qne notes that 


1) Closed shop is deadstarted from a TPXXXK file in 
the CLSH catalog. 


2) Specifying D=T»s for NVEINST»s causes deadstart to 
pause for operator intervention. 


3) Using DCF deck 490 for continuation suppresses 
redundant (and possibly damaging) reexecution of 
the configuration prolog. 


A normal deadstart is used when bringing up NOS/VE at 
the beginning of closed shop or following a system 
failure. The operators in this examples types 


NVECLSH. 


NOS/VE will recover (Cif necessary) and deadstart. 
When recovery runSs the operator must respond to a 
request for input from the MANLC utility. See note 4 at 
the end of this section for more information. 
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If it Is necessary to reinitialize the system devices 
or if the installation is upgrading to a new version of 
NOS/VE»s the operator keys 


NVEINST. 


This causes deadstart to pause and wait for operator 
input when deadstart commands are being pracesseds 
There are two cas@s requiring discussion here, The 
first is the case of upgrading to a new and compatible 
version of NOS/VE. The second case is used only when it 
is necessary to reinitialize the system device. 


The first case Involves the installation of a new 
version of NOS/VE. In order to instail a new version of 
the systems the old system must have been idled in an 
orderly way. A new system cannot be Installed ifs 
following a crash» the system being superceded was not 
recovered. Assuming everything in the old system Is 
tidy», and the file systems are compatibles, the operator 
keys 


KeUSECP EMPTY. 

K»SETSA INSTALL _JGB_TEMPLATES 1. 

K.G0. 

when the system displays the deadstart command deck and 
prompts for input. The new system is instaileds the 
flie system is oreserveds and deadstart proceeds. 


The second case amounts to an instajlation 
deadstart. This should he used only with full knowledge 
that any files which may have existed on mass storage 
prior to this deadstart» will be blasted. into. oblivion 
by_if. | 


An installation deadstart wil! be required if 


1) This is the initial Installation of a recoverable 
version of NOS/VE. 


2) If the file systems of the system being installed 
and tha system being superceded are not 
compatible, 


3) If the file system has heen damaged beyond the 
possibility of recovery. 


An installation deadstart is effected by typing 
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KeINITDD VSNOO1. 


K.eSO. 


when 


operator 


NOTES? 


1. 


3 


4 


the deadstart command deck is displayad and the 
is prompted for input. 

The CMDS1 File used to deadstart NOS/VE must have 
the DEBUG2 flag set to TRUE. When NOS/VE is 
deadstarteds the catalog specified by the UN 
parameter js first in the search order for CMDS1l» 
Followed by the catatoaq specified by the B 
parameter, 

See Section 3.3 of the Integration Procedures 
Notebook for oather information about the CMDS1 
File. 

If NOS/VE crashes and a dump is desired (in the 


context of our second example) 


» 


i. Type du at the MDD console. The message 
WMRITING IMAGE FILE” should appear 
immediately. The message "IMAGE FILE 
COMPLETE™ sheuld appear 3 few moments 
fater. 

ii. Push the deadstart button. 
iii. Take the EDD dump. 
ive Do a jevel 3 NOS deadstart. 


Alternatively the operator can skip step i if 
she/he is sure to redeadstart NOS/VE after step 
ive In this event the system will detect that the 
image file was never createds will create ones and 
will recover from it. 


A recovery deadstart which Is under the control of 
a SETVE command in which D=T was specified will 
pause in the recovery system with the message 
"OPERATOR INTERVENTION BEFORE RECOVERY BEGINS”, 
The system is executing the logical configuration 
utility at this voolnt. In order to exit this 
utility and allow recovery to proceed the operator 
types KeOUIT (no period). For more details on the 
use of the LCU see Section 4.9 of this document 
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and the NOS/VE Installation Command Interface 
ERS. 
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6.0 SYSTEM_CORE DEBUGGER 


The System Core dehugger provides a set of capabilities 
intended to assist in debugging the operating system. 
Services provided by the debugger are task oriented: selection 
of the tasks to be debugged must be made via debugger 
subcommandse. No tasks will te under contre! of the debugger 
unless they are selected. The selection capability aliows any 
number of tasks to be debugged simultaneously; from one task 
to all tasks in the system. Qbviously a capability this 
powerful must be used with some cares The System Core 
debugger uses the debug hardware to provide these 
capabilities. 


Sel SYSQEBUS 


The purpose of this command is to initiate execution of the 
system core debugger. This command can be issued from the 
deadstart command file or as a command in any job. 

Ssysdebug 


This command has no parameters; afl information the 
debugger requires is provided via subcommands.. 


The system core debugger can also he invoked from the MDD 
console. The format of the command is: 


DO nesysdebdug 

where on is the job ordinal of the desired jobe The debugger 
is brought up in the job monitor task cf the job. All system 
core debugger subcommands are availables but must be prefixed 
by the MDD command DQ. 

The system core debugger can also be brought up (from the 
MDD console) by specifying a global task ide The format of 
the command is: 

DO netdebug aaggqag 
The value of nm is ignoreds and the value aggqgggg specifies the 
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NOS/VE globs!i task id (3 hex bytes) cf the task te obring the 
debugger up ine If the task id is invalids then the command 
will be ignored. 


6.2 SUBCOMMAND PARAMETER DEFINITIONS 


<name> s2= 1-8 character breakpoint name 
<condition> :2= READ WRITES RNIS BRANCHSCALLIDIVFELTSARLOS 3 
AROVFLUIEXOVFLIEXUMFLUFPLOSSFPINDEFLINVBDP 


<base> %:3= process virtuai address 
Coffset> +2: Integer 

<length> is: integer 

<frame> t3= 1.4.-100 

<count> +22 1..10000 

<regid> :3= xiaiP 

Cregno> 2:22 0.421536. .0F(16) 
<value> t3= Integer 

<timed i3:= 1,.¢0¢2**31L1)—1 
<vstring> 32+ 'charstring! 
<datatype> s2= HEXSASCILIIASCIDEC 


= 128 


<changqe_count> = 
csc ILLTAUTOSSAVE 


<selector> FL 


6.3 SYSTEM CORE DEBUGGER _SUBCOMMANDS 


Within the descriptions which follows optional parameters 
are enclosed in brackets. Default values for optional 
Parameters are also defined, 


6e301 SELECT 


The purpose of this subcommand is to select the tasks In 
which the system core debugger is to be active. When the 
debugger is first calleds it is not active in any taske To 
use the debugger therefores it is necessary to select the 
tasks in which it is te beactive. 


sefect <selection optiond  (C<ring numberd>d {| <active job list 
ordinal>] 


selection_option: This parameter specifies one of a 
series of selection options used to control the 
tasks In which the debugger will be active and some 
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other debug options. The selections are remain in 
effect until! they are explicitly changed with 
Subsequent SELECT subcommands. Vatid selection 
options are? 


<rightileft> - This selects the screen for the debug. 


display. The display stays active when the screen 
is switched, 


<jobmonitorinojobmenitor> - This selects whether or 
not to debug job monitor tasks. 


<userjinouser> - This selects whether or not to debug 
user tasks (ise. those that are not job 
monitors). 


<highring> - This specifies the highest ring in 
which debug traps will be recognized. Treps 
occurring in rings above this selection will be 
ignored, 


<jobjinojob> - This enables or disables debugging for 
the job at the svecified active jeb tist 
ordinal. The system job has an active job tist 
ordinal of zerce 


alijobsinojobs> - This activates or deactivates 
debugging in all jobs. 


The initial selections are: RIGHT» NOSTEPs» 
NOJGBMONITORs NOUSERs, HIGHRING=3»5 NOJOBS. 


603e2 BREAKPOINT |: 8 


The purpose of this subcommand is to select ao program 
interrupt which is to take place upon occurrence of a2 
specified condition within a specified virtual address range. 


breakpoint <name> <condition> C<baser>] [<offset>] [<length>] 

The <name> is any user supplied name for identifying the 
breakpoint. A maximun of thirty two breakpoints can be 
selected. When a trap occurss the “name> of the breakpoint 
which caused the trap is displayed. 


The base parameter is required when specifying a new 
breakpoint name}; offset and length specifications are optional! 
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in this case. When adding a new condition selection to. an 
existing breakpoints, bases offsets and length oarameters may 
not be specified. 


Bases offsets and tength parameters define the desired 
virtual address range? <base> + <offset> yieids a 
First-byte-address; first-byte-acdress + <length> -1 yields a 
fast byte address. 


Default parameter values: 
<offset>: 0 
€lenath>: 1 

e303 REMOVE_BREAKPOINT ¢| &8 

The purpose of this subcommand is to deselect a previously 
selected pregram inte 
remove breakpoint <name> [<condition>] 

If onty the name parameter is specifieds, ali conditions 
associated with the breakpoint are desetected and ali evidence 
of the breakpoint is removed, If the condition parameter is 
specified» onty that candition is deselected; howevers if the 


soecified condition is the only condition selecteds all 
evidence of the named breakpoint is removed, 


60304 LIST BREAKPOINT ?!} LB 

The purpose of this subcommand Is to provide a tist of 
currently selected hreakp and associated conditions. 
fist breakpoint [<name>] 

If the name parameter is specifieds information is 
displayed for the named breakpoint ontye If the name 


parameter is not svecifieds information is displayed for all 
currently defined breakpoints. 
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64345 CHANGE_LBREAKPOINT 7? CB 


The purpose of this subcommand is to change the virtua! 
address range of a previ specified breakpoint. 


change_breakpoint <name> <base> [<offset>] C<length>] 


Bases offsets, and length parameters define the desired 
virtual address range: <base> + <offset> yields a 
first-byte-address} first-byte-address + <length> -1 yields a 
last byte address. 


Nefault parameter values? 
<offset>: 3 
<length>: 1 


62305 TRACE BACK | TB 


The purpose of this subcommand is to provide information 
relevant to stack frame associated with an Interrupted 
procedure and its predecessor procedures. Validation of PVA'"s 
is now performed. 


Information displayed for each selected stack frame 
consists of: 


Stack frame number3 

- Current PRkaddress of the associated procedure; 
Virtual address of the start of the steck frame; 
- Virtual address of the stack frame save areae 


trace-back [<frame>] [<count>] CFULLS SHORT] 


The frame parameter specifies the number of the first stack 
frame for which information is to be dispitayed. Stack frame 
number one is associated with the Interrupted procedures stack 
frame two is associated with the interrupted procedure's 
predecessors etc. 


The module name provided on the traceback Is usually 
correct but not guaranteed. 


The count parameter specifies the total number of stack 
frames for which information is to be displayed. 
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6e326 TRACE BACK | TB 


Default parameter values; 
<frame>: 1 
Ccount>: 1 

60307 DISPLAY_STACK_FRAME 1% DSF 

The purpose of this subcommand is to display selected 
information from a specifi stack frame. 
display stack _ frame [(<frame>] [<selector>] 

The frame parameter specifies the number of the stack frame 
for which information is to be displayed. {Stack frame number 
one is associated with the interrupted procedures stack frame 
two is associated with the interrupted procedure'ts 


predecessors etce) 


The selector parameter identifies a region of the specified 
stack frame: 


AUTO: Causes the automatic region of the stack frame te be 
displayed. 


SAVE: Causes the save area of the stack frame to be 
displayed. 


FULL: Causes both the automatic and save areas of the stack 
frame to be displayed. 


Default parameter values? 

<frame>: 1 

€selector>: FULL 
60348 DISPLAY REGISTER | DR 

The purpose of this subcommand is to display the contents 

of a specified registe interrupted procedure. 
display _register <regid> (<regnod] (<datatyped] 
Default parameter values; 

Cregno>: Oo 
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603.8 DISPLAY_LREGISTER ¢ DR 


€<datatype>d: HEX 
603.9 DISPLAY_MEMORY | OM 


The purpose of this subcommand is to display the contents 
of a specified area of virtual memory. Validation of PVA's is 
now oerformed,. 
display _memory <base> [<length>] 


Default parameter values; 


<length>: 8 
603210 CHANGE MEMORY { CM 


The purpose of this subcommand is to set a specified vyaiue 
Into a specified toca of virtual memory for a specified number 
of bytes. Validation of PVA's is now performed, 
change _meamory <base> <walue> <change_count> 
Default parameter values: 


<change_count>: 1 
HeSell RUN 
The purpose of this subcommand is to invoke program 


execution after a selected p interrupt has occurred, 


run 
6.3012 SUPER_CHANGE_MEMORY {| SCM 


The purpose of this subcommand is the same as the change 
memory subcommands that iss to change the contents of virtual 
memor ye It differs from change memorys howevers in that it 
will change the attributes of the segment to allow memory to 
be writtens and then change the attributes back to their 
original values. 
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603012 SUPER_CHANGE_MEMORY 3} SCM 


The command format Is the same as the chanae memory 
subcommand. 


603013 FORMAT §$ FMT 


The purpose of this subcommand is to set the system core 
debugger into a mode where all subcommand output is sent to a 
permanent file. This is done by having the task running the 
debugger communicate with another task running in the system 


jobe It is this other task that actually creates and writes 
the permanent file, The entry point of this task is 


OCSPSBROKEN_JOBR_DUMP_TASK. It will normally be initiated by 
the OS procedure. If it is not runnings a diagnostic will be 
issued. This task will create successive cycles of the 
permanent File DUMP! in the S$SYSTEM catalog. These files 
contain ASCII text data written in BAM variable records. The 
Parameter to this command is a string which will be output as 
the first line of the file. 


format string 
6.3014 UNFORMAT | UNFMT 


The puroos? of this subcommand is to leave the output mode 
established by the FORMAT command. Output will again be sent 
to the operator console. At this point the permanent file 
will be flushed to mass storage. 


unformat 
603015 DISPLAY MONITOR FAULT | DISMF 


The purpose of this subcommand is to display any monitor 
faults present in this taske See the section titled 'NOS/VE 
Processing of Job Mode Software Errors! for more informations 


Ali monitor fault buffers are displayed in the hope they 
will show some task history. If agiven fault buffer is 
invalid the message “following fault is not present" iis 
displayed. 


disptay monitor fault 


Cycle 7s July-August 1982 


6-9 
NOS/VeE Cycle 7 Heipful Hints 

wn ee : “e es : eee 09/14/82 — 
6.0 SYSTEM CORE DEBUGGER 

feBe216 DISPLAY_XCB $$ DISKXCB 


6He3e16 DISPLAY_XCB : DISKXCB 


The purpose of this subcemmand is to display all of the 
Fields of the current task's (i.@e,» the task running the 
debugger) execution contro! block. 


He30el7 DISPLAY_TASKLENVIRONMENT ¢ DISTE 


The purpose of this subcommand is to display the XCB of al! 
tasks running within the current Job (i.e@es the job with the 
task running the debugger). If the command is entered while 
the debugger is in format modes then a full XC3 is displayed,» 
otherwisa just the task names XCB address and giobal task id 
are displayed. 
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7.0 NOS/VE PROCESSING O£_J03_MODE_SOEIWARE ERRORS 


7ol INTRODUCTION 


Tasks running in job mode willl occasionally cause an error 
which is detected either by the hardware or NOS/VE monitor. 
The action taken when an error like this occurs is controlled 
by various system attributes. The purpose of this section is 
to discuss the types of @rrors and the effect a given system 
attribute will have upon the handting of the error. 


7.2 LTYPES_OF_ ERRORS 


1) BROKEN TASK: A broken task is a task In which the trap 
mechanism is not able to function correctly. NOS/VE 
monitor will attempt to repair the trap mechanism and = send 
a broken task Fault to the task. The specific cases of 2 
broken task are: 


system error job mode software has 
declared the task to be 
broken. (This is a special 
case of broken task.) 


monitor fault buffer full job mode errors are 
occuring but are not being 
processed by job mode. 


traps disabled a job mode error has 
occurred while traps were 
disabled. 


Invalid AQ the task'’s AO register was 
invalid. 


UCRI/JMCR traps disabled | UCR/MCR error occurred with 
traps disabied. 


2) MCR FAULT? This error signifies that job mode caused a 
hardware detected MCR fauit. This may be caused by 
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software or hardware detected uncorrectablie error. 


3) UNKNOWN SYSTEM REQUEST: This error signifies that job mede 
issued a monitor request that is either invalid or cannot 
be issued from the rina it was issued frome 


4) SEGMENT ACCESS FAULTS: These errors signify that job mode 
encountered or caused one oF the Following errors: 


~ page fault for an address greater than EQI ona 
read-only file (segment) 


~- disk read error 


These errors either originate in NOS/VE monitor or cause 
the hardware to exchange to monitor. Depending on the values 
of certain system attributess monitor will halt or reflect the 
error back te jab mode as a monitor default. 


It is at this point that the system core debugger can be 
activated. (See the definition of SYSTEM_DEBUG_RING in the 
next section.) 


Tne normal job mode [S actions for these faults are? 
broken task exit 
MCR fault cause condition 
Invalid system request exit 
segment access cause condition 


7o3 SYSTEM_ATTRIBUTES_ FOR CRROR PROCESSING 


The following system attributes can be set or displayed by 
the SETSA and OISSA commands, 


7301 HALTRING 


If a broken task or MCR fault occurs at or below the value 
of HALTRING (P register ring number)»s NOS/VE monitor will halt 
the system. Broken tasks occurring above HALTRING will cause 
2@monitor fault to be sent back to job mode. 
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703.2 SYSTEMLERROR_HANG_COUNT 


This is the number of broken task errors aijlowad to occur 
in any given task before that task is considered a hung taske 


7e303 HALTLON_HUNG_TASK 


If this attribute is trues then an occurence of a hung task 
will cause NOS/VE monitor to hait the system. If the 
attribute Is false, the task will be sent a signal to ‘thang? 
itselfs ie@.e to go inte an infinite wait doing nothing. Jobs 
with hung tasks will have a *H in the status field on the 
operator CP display. 


A hung task wild aiso occur if any error happens In job 
mode ring 1. 


70304 SYSTEM_DEBUG_LRING 


If an error (broken tasks MCR faults unknown system 
requests or seqment access fault) occurs at or below the value 
of this attribute (P register ring number)» the system core 
debugger wlll he invoked within the task. At that point in 
time the task environment can be examined by using system core 
debugger commandse 


If the RUN command is issued te the debuggers the system 
witli take its normal action for the specific fault. 


703095 DUMP_WHEN_DEBUG 


When the system core debugger is invoked by a fault at or 
below SYSTEMLDERUG_RING and the DUMP_LWHEN_DEBUG attribute is 
trues the debugger will automaticaily create a dump of the 
task (see systam core debugger command FORMAT). When the dump 
is completes, normal fault action wilt take places. The 
following system core debugger commands are executed during an 
automatic dump: 


FORMAT automatic dump data 
TB 1 1900 
DISMF 
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NISXCB 

DM 00300000000 10000(16) 
DM 00490000000 10000(16) 
DM 00500000000 16000116) 
DM GO6CCCOCO00 19000116) 
DM OOFOOOGOOOO 10000116) 
DM 610090009000 1000016) 
DM 011900000000 100090116) 
DISTE 

UN FORMAT 
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8.9 STAND ALONE_DEADSTARTI 


A standalone deadstart tape is a 9=-tracks», unlabeleds I 
formats 1600 BPI density tape (produced by the NVESYS 
procedure). Jo deadstart in standalone modes perform the 
Following steps? 


1) Set the deadstart panel for standard disk deadstart. 


2) Perform an alternate deadstart to the NVE deadstart tape 
using CTI. The CTI parameters on the 'Pt display should 
be set as follows 

L 0 
C <'c! parameter of the SETVE preocedure> 
D <'D! parameter of the SETVE procedure 

= Y when display is true 

= N when no display> 

CH' parameter of the SETVE procedure> 


D 
D 
W14 = <? 


3) The tape should move and eventually the message 
"PROCEED" will appear on the fower left on the consoles 


4) Enter CRoMxsRBR=OCCOGO0C000CO0LYD (Editor's note: 16 
zeros!) 
where Mw is M1 for $1 
M2 for $2 
M3 for $3 


This clears the memory bounds register which is set by th 
deadstart. 


5) Enter DReP2 This disptays the CPU registers. The SIT 
should be changing; If nots give up. 


6) At this point the system core is toaded and can be 
patched. The commands to dispiay and change memory are 
documented in IPNDOC. 


7) To start the system enter SS The CPU registers should 
spin; if they ever stop the CPU has haitted. 


8) Enter DO to display the system dayfile on the right 
screens 
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9) 


10) 


11) 


Enter NVE deadstart commands when the system requests 
them. ('D = Y' must be specified on the *P* disotay for 
this to happen.) 


Note: Standalone deadstart is always a ‘'auick? 
deadstart» $0 no recovery of permanent files is 
possible. *OUICKDS? mode is set internally and need not 
be specified. 


Enter DJ to display the system job dayfile when the 
system requests it. The 'DJ*® display is on the tJleft 
screens 


Now the system is operational and commands can be 
entered. 
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9.0 INIESACTIVE_ PROJECT DUMP ANALYSIS PROCEDURES 


The following procedures were developed by the Interactive 
project to assist them in interoreting dumps. They guarantee 
the procedures work if your user name is IFP3 otherwise caveat 
emptor. For more information about these procedures,» contact 
Fred Bischke,. 


The following dump analysis procedures are available in the 
IFP catalogs 


9.1 
EDDSIM 
This is a CCL procedure which brings an EDD dump tape on a 


specified 


VSN into the simulator. The procedure can be accessed from 
the IFP 


catalog as follows: 
getseddsim/un=ifp 

heginsseddsimsvsn ( vsn is the vsn of the EDD dump tape ) 

9.2 
ANALEXC 
This is a Stimulator INCLUDE file which does a preliminary 

analysis of 
the current simulator exchange package ( when the system 


crashes In task 


Cycle 7s July-August 1982 


9-2 
NOS/VE Cycle 7 Helpful Hints 
09/14/82 


9.0 INTERACTIVE PROJECT DUMP ANALYSIS PROCEDURES 
942 


servicess this will normally be JPS ). A ar @xc=mon or ar 
exc=rma can be 


used to get into another exchange package before doing the 
include. . . 


The include file is ANALEXC/UN=IFP,. It can be called from 
the simulator 


as follows: 
'gatsanalexc/unzifp! 3 include analexc 


(carriage return) a tone carriage return must be entered 
after an INCLUDE 
in order to start it up 


9.3 
SEGDUMP 


This is a CCL procedure which calls OSDIV to dump a 
specified seaqment to 
a Jist file which can then be examined with an editor or 
printed. 
The procedure can be accessed from within the Simulator as 
Follows: 
'getssegdump/unz=ifp! 3 theginsssegdumpssegsiensfilesexcscpf! <* 


The segdump parameters are; 
seg - segment number in hex ( default Is 1 ) 
length — number of bytes to dump in hex ( default is 10000 ) 
fist - name of the Jtist file ( default is LIST ) 
exc ~ reference exchange package ( defauit is JPS } 
epf —- name of checkooint file ( default Is CPF ) 
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In most cases of task services debugginas onty the seg 
paraneter is 


needed. 


ANALJOB 
This is a CCL procedure which uses ODSDIVs, KMEDIT and the 
Simulator to 


perform an analysis of all tasks in a specified job. The 
procedure can 


be accessed from within the simulator as follows: 
'getsanaljoeb/un=I]Fo! 3 theginssanai jobssegscerf! 


Tha analjob parameters are: 
seg ~ the monitor segment which contains the exchange 
packases of the job ( 14 Is the system jobs 15 is job 1 etc. 
) (€ default is 14 ) 


cpf - the name of the simulator file { default is CPF ) 

After the procedure has completeds a tist of the RMA's of 
the 

Job's exchange packages can he obtained by doing the 
following: 

inciude tplist 


(carriage return) 


A traceback of all tasks in the job can be obtained by 
doing the 
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ak sa AbD: fbb Wd ea hc hb ik Wi AV be dtd Od dod OB Wa We, OO Ld od OO Wk De BE Si GUNG i We Od has ab 0A ind ae ead ba bo Gita Ge a a 
following: 
include tbhlist 
(carriage return) 


inctlude thbhrun 


(carriage return) 
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1.0 Hardware Overview 


An introduction to CYBER 180 
C180 Instant 


Model Independent General Design Specification - 
ARH1709 


220 NOS Reference Manuals 


XEDIT V3.0 — 604557306 
IAF V1.9 User's Guide - 6045526¢ 


NOS Version 2 Reference Set —- Vol 3s 60459586 - Vol 
49 60459690 


NOS Systems Programmer's Instant - 60459370 

NOS Version 2 Operator/Analyst Handbook - 60459310 
NOS Version 2 Diagnostic Index - 60459390 

NOS A170 ERS 


NOS A170 GID — ARH3060 


3.9 NOS/VE Reference Documents 


3.1 


302 


Program Interface ERS —- ARH3610 - obtained from 
Karen Rubey (482-3966) or via SES .-TOOLDCC 


Command Interface ERS - ARH3609 = obtained from 
Karen Rubey (482-3966) or via SES.~TOGLOLC 


NOS/VE Procedures and Conventions - SESDO10 - 
obtained by SES.TOOQLDOC 


Listing of all NOS/VE Modules - obtained by 
SESsDEVI.LISTNVE. See Integration Procedures 
Notebook for datails. - 


> NOS/VE Internal Interface Maintenance Procedures 


Memo available from SeC. Woods 


Integration Procedures Notebook Qbtained by: 
AcquiresTPNDQC ZUN=DEV1L. SESsPRINTs IPNDOC., 
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